Schnittstellenbeschreibung [SES.NVONB.DAVE.AntragAnbieter]

Transkript

1 - VM-BNetzA - Nummernverwaltung im Ortsnetzbereich (NV-ONB) Schnittstellenbeschreibung [SES.NVONB.DAVE.AntragAnbieter] Version 1.2 Stand:

2 2010 Bundesnetzagentur Seite 2

3 Inhaltsverzeichnis 0 Allgemeines Zweck des Dokuments Beschreibung der Schnittstelle [SES.NVONB.DAVE.AntragAnbieter] Verwendung der Schnittstelle Syntax der Schnittstelle [SES.NVONB.DAVE.AntragAnbieter.ANT] [SES.NVONB.DAVE.AntragAnbieter.RES] Semantik der Schnittstelle [SES.NVONB.DAVE.AntragAnbieter.ANT] [SES.NVONB.DAVE.AntragAnbieter.RES] Synchronisation des Datenaustausches Besonderheiten Bundesnetzagentur Seite 3

4 0 Allgemeines Änderungsübersicht lfd. Nr. Datum Grund der Änderung Geänderte Seiten Verantwortlicher Bearbeiter 1 01/2008 Anpassung der Schnittstelle Alle M. Hoppe 2 07/2009 Anpassung Semantik 14; 15 M. Hoppe 2010 Bundesnetzagentur Seite 4

5 Tabellenverzeichnis Tabelle 1: Syntax der Dateien des Typs NVONB.DAVE.AntragAnbieter.<jjjjmmtt>.ANT.csv.11 Tabelle 2: Syntax der Dateien des Typs NVONB.DAVE.AntragAnbieter.<jjjjmmtt>.RES.csv.12 Tabelle 3: Semantik der Dateien des Typs NVONB.DAVE.AntragAnbieter.<jjjjmmtt>.ANT.csv 14 Tabelle 4: Semantik der Dateien des Typs NVONB.DAVE.AntragAnbieter.<jjjjmmtt>.RES.csv Bundesnetzagentur Seite 5

6 Abbildungsverzeichnis 2010 Bundesnetzagentur Seite 6

7 2010 Bundesnetzagentur Seite 7

8 Referenzierte Dokumente [MIT163/2006] - Mitteilung Nr. 163/2006: Zuteilungsverfahren für Ortsnetzrufnummern Veröffentlicht im Amtsblatt der Bundesnetzagentur 9/2006; [TNGebV] - Telekommunikations-Nummerngebührenverordnung Veröffentlicht im Bundesgesetzblatt 1887; August 1999 [TKG] - Telekommunikationsgesetz vom inklusive der bis zum durchgeführten Änderungen. [VFG25/2006] - Verfügung Nr. 26/2006: Struktur und Ausgestaltung des Nummernbereichs für Ortsnetzrufnummern Veröffentlicht im Amtsblatt der Bundesnetzagentur 9/2006; Bundesnetzagentur Seite 8

9 1 Zweck des Dokuments Die Anwendung Nummernverwaltung im Ortsnetzbereich (NV-ONB) dient der Bundesnetzagentur zur Verwaltung des Nummernraumes im Ortsnetzbereich gem. [TKG], [TNGebV], [VFG25/2006] und [MIT162/2006]. Im Rahmen der Verwaltung des Nummernraumes werden den Anbietern durch die BNetzA Rufnummernkontingente zugeteilt, die von diesen eigenständig an die jeweiligen Endkunden vergeben werden können. Zur elektronischen Beantragung durch die Anbieter stellt die Bundesnetzagentur den Anbietern das Antragsverfahren DAVE zur Verfügung. DAVE ermöglicht eine halbautomatisierte Beantragung von Rufnummernblöcken für Ortsnetzbereiche. Für die Beantragung von Rufnummernblöcken soll das Datenträgerverfahren (DAVE) der Bundesnetzagentur um eine Schnittstelle zu den Kundenmanagementsystemen der Anbieter [AntragAnbieter] erweitert werden. Das vorliegende Dokument dient der Spezifikation dieser Schnittstelle Bundesnetzagentur, IS 12 Seite 9

10 2 Beschreibung der Schnittstelle [SES.NVONB.DAVE.AntragAnbieter] 2.1 Verwendung der Schnittstelle [SES.NVONB.DAVE.AntragAnbieter] bezeichnet die bidirektionale Schnittstelle des Systems [NVONB.DAVE] zu [AntragAnbieter]. Über diese Schnittstelle erfolgt der Austausch folgender Daten: zu beantragende RNB (Antragsdaten) ([SES.NVONB.DAVE.AntragAnbieter.ANT] ) Beantragungsfähigkeit der beantragten RNB (Prüfdaten) ([SES.NVONB.DAVE.AntragAnbieter.RES]) Die Schnittstelle ist als Dateischnittstelle ausgelegt. 2.2 Syntax der Schnittstelle Aus Sicht von [NVONB.DAVE] ist [SES.NVONB.DAVE.AntragAnbieter] eine Ein- und Ausgabe-Schnittstelle, d. h. der Datenfluss erfolgt bidirektional zwischen den Systemen [NVONB.DAVE] und den antragsverarbeitenden Systemen der Anbieter [AntragAnbieter]. Die Datenübergabe erfolgt dateibasiert. Es existiert kein Kommunikationsprotokoll (im originären Sinn). Die Synchronisation des Datenaustausches mit Peripherverfahren erfolgt gemäß Kapitel 2.4. Definition 1 - Syntaktischer Aufbau der Dateinamen Die Dateinamen der über [SES.NVONB.DAVE.AntragAnbieter] bereitgestellten Dateien folgen der Syntax: Die über [SES.NVONB.DAVE.AntragAnbieter] ausgetauschten Ein- und Ausgabedateien sind Textdateien, die die Nutzdaten enthalten. Über die Schnittstelle [SES.NVONB.DAVE.AntragAnbieter] wird je Stichtag maximal eine Antragsdatei bereitgestellt. Die Verarbeitung einer Antragsdatei resultiert in einer entsprechenden Responsedatei, die für jeden Datensatz der Antragdatei den Verarbeitungsstatus kommuniziert. Das Stichtagsdatum der Responsedatei entspricht dem der korrespondierenden Antragdatei Bundesnetzagentur Seite 10

11 2.2.1 [SES.NVONB.DAVE.AntragAnbieter.ANT] Definition 2 - Antrag-Datei Eine Antrag-Datei bezeichnet eine Eingabe-Datei für [NVONB.DAVE] aus [AntragAnbieter], die Antragsdaten enthält. Eine Antrag-Datei ist eine UTF-8-Datei, in der die Informationen zeilenweise abgelegt werden, d. h. eine Zeile entspricht einem Datensatz. Als Trennsymbol wird ein Semikolon ";" verwendet. Der Zeilenabschluss wird durch <CR><LF> gekennzeichnet. Der Dateiabschluss wird durch <SUB> (ASCII 26) gekennzeichnet. Die erste Zeile der Datei beinhaltet die Spaltenbezeichnungen. Der syntaktische Aufbau dieser Datei wird durch die folgende Definition geregelt. Definition 3 - Antrag-Datei (Syntax der Dateien des Typs NVONB.DAVE.AntragAnbieter.<jjjjmmtt>.ANT.csv ) Eine Datei des Typs NVONB.DAVE.AntragAnbieter.<jjjjmmtt>.ANT.csv setzt sich aus mehreren Zeilen zusammen, wobei eine Zeile wie folgt definiert wird: lfd Nr. Bezeichnung 1 Ortsnetzkennzahl 2 Rufnummernblock 3 RNBGroesse 4 RNBAnzahl 5 Wirksamkeitsdatum 6 Kennzeichen Aufeinanderfolgende RNB Tabelle 1: Syntax der Dateien des Typs NVONB.DAVE.AntragAnbieter.<jjjjmmtt>.ANT.csv 2010 Bundesnetzagentur Seite 11

12 2.2.2 [SES.NVONB.DAVE.AntragAnbieter.RES] Definition 4 - Prüf-Datei Eine Prüf-Datei bezeichnet eine Ausgabe-Datei für [AntragAnbieter] aus [NVONB.DAVE], die Informationen über die Beantragungsfähigkeit der Antragsdaten enthält. Eine Response-Datei ist eine UTF-8-Datei, in der die Informationen zeilenweise abgelegt werden, d. h. eine Zeile entspricht einem Datensatz. Als Trennsymbol wird ein Semikolon ";" verwendet. Der Zeilenabschluss wird durch <CR><LF> gekennzeichnet. Der Dateiabschluss wird durch <SUB> (ASCII 26) gekennzeichnet. Die erste Zeile der Datei beinhaltet die Spaltenbezeichnungen. Der syntaktische Aufbau dieser Dateien wird durch die folgenden Definitionen geregelt. Definition 5 - Prüf-Datei (Syntax der Dateien des Typs NVONB.DAVE.AntragAnbieter.<jjjjmmtt>.RES.csv ) Eine Datei des Typs NVONB.DAVE.AntragAnbieter.<jjjjmmtt>.RES.csv setzt sich aus mehreren Zeilen zusammen, wobei eine Zeile wie folgt definiert wird: lfd Nr. Bezeichnung 1 Ortsnetzkennzahl 2 Rufnummernblock 3 RNBGroesse 4 RNBAnzahl 5 Wirksamkeitsdatum 6 Kennzeichen Aufeinanderfolgende RNB 7 Kennzeichen BeantragungGueltig 8 Begründung Tabelle 2: Syntax der Dateien des Typs NVONB.DAVE.AntragAnbieter.<jjjjmmtt>.RES.csv 2010 Bundesnetzagentur Seite 12

13 2.3 Semantik der Schnittstelle Den syntaktischen Elementen der [SES.NVONB.DAVE.AntragAnbieter]-Dateien werden die in den folgenden Kapiteln aufgeführten Bedeutungen zugewiesen [SES.NVONB.DAVE.AntragAnbieter.ANT] Die Semantik der Datenelemente der Dateien des Typs NVONB.DAVE.AntragAnbieter.<jjjjmmtt>.ANT.csv stellt sich wie folgt dar: Datenfeldnummer: 1 Ortsnetzkennzahl Ortsnetzkennzahl aus dem die Rufnummernblöcke beantragt werden sollen (ohne führende 0 ) Datenfeldnummer: 2 Rufnummernblock Wunsch-Rufnummernblock der beantragt werden soll. 0, wenn kein Wunsch-RNB Datenfeldnummer: 3 RNBGroesse Die Größe der beantragten RNB (in Rufnummern) Wertebereich: {100,1000,10000} Datenfeldnummer: 4 RNBAnzahl Anzahl der beantragten RNB Wertebereich: 0 < RNBAnzahl <= MaxInt32 (Ist ein Wunsch-RNB angegeben, muß gelten: RNBAnzahl=1) Datenfeldnummer: 5 Wirksamkeitsdatum Länge: 10 alpha im Format tt.mm.jjjj Das Datum an dem die Zuteilung wirksam werden soll (optional) (Wertebereich: Dieses Datum muss zwischen 30 und 180 Tage nach dem Eingangsdatum des Antrages bei der Bundesnetzagentur liegen. Das Wirksamkeitsdatum muss für alle RNB- Beantragungen eines Ortsnetzes gleich sein) 2010 Bundesnetzagentur Seite 13

14 Datenfeldnummer: 6 Kennzeichen Aufeinanderfolgende RNB Kennzeichen, ob die beantragten RNB aufeinanderfolgend sein sollen: 0 nicht aufeinanderfolgend 1 aufeinanderfolgend (Nur relevant wenn RNBAnzahl>1) Tabelle 3: Semantik der Dateien des Typs NVONB.DAVE.AntragAnbieter.<jjjjmmtt>.ANT.csv 2010 Bundesnetzagentur Seite 14

15 2.3.2 [SES.NVONB.DAVE.AntragAnbieter.RES] Die Semantik der Datenelemente der Dateien des Typs NVONB.DAVE.AntragAnbieter.<jjjjmmtt>.RES.csv stellt sich wie folgt dar: Datenfeldnummer: 1 Ortsnetzkennzahl Numerisch Ortsnetzkennzahl aus dem die Rufnummernblöcke beantragt werden sollen (ohne führende 0 ) Datenfeldnummer: 2 Rufnummernblock Rufnummernblock der beantragt wird Datenfeldnummer: 3 RNBGroesse Die Größe der beantragten RNB (in Rufnummern) Wertebereich: {100,1000,10000} Datenfeldnummer: 4 RNBAnzahl Anzahl der beantragten RNB Wertebereich: 0 < RNBAnzahl <= MaxInt32 Datenfeldnummer: 5 Kennzeichen Aufeinanderfolgende RNB Kennzeichen, ob die beantragten RNB aufeinanderfolgend sein sollen: 0 nicht aufeinanderfolgend 1 aufeinanderfolgend Datenfeldnummer: 6 Wirksamkeitsdatum Länge: 10 alpha im Format tt.mm.jjjj Das Datum an dem die Zuteilung Wirksam werden soll Datenfeldnummer: 7 Kennzeichen BeantragungGueltig Wertebereich: 0 Der/Die RNB konnten nicht beantragt werden. 1 Der/Die RNB konnten beantragt werden Bundesnetzagentur Seite 15

16 Datenfeldnummer: 7 Begründung Länge: Variable (max. 255 Zeichen) alpha Im Falle BeantragungGueltig=0: Begründung für die nicht erfolgreiche Beantragung. Tabelle 4: Semantik der Dateien des Typs NVONB.DAVE.AntragAnbieter.<jjjjmmtt>.RES.csv 2.4 Synchronisation des Datenaustausches Die Synchronisation des Datenaustausches mit peripheren Anwendungen erfolgt über eine Semaphordatei. Der Zugriff einer Anwendung auf das Dateiverzeichnis in dem die beschriebenen Dateien abgelegt werden wird durch die Existenz einer Semaphordatei signalisiert. Der Syntax des Dateinamens der Semaphordatei wird wie folgt definiert: Die Semaphordatei ist eine UTF-8-Datei, in der die Information über das Verfahren, das die Semaphordatei angelegt hat, formlos abgelegt ist. Der Zeilenabschluss wird durch <CR><LF> gekennzeichnet. Ist der Zugriff auf das Dateiverzeichnis beendet, wird die Semaphordatei gelöscht. 2.5 Besonderheiten Keine Bundesnetzagentur Seite 16