Das Paket UID

Dieses Handbuch beschreibt die Verwendung der DLE zur Prüfung von UID-Nummern bei den staatlichen Behörden.
Die Prüfung der UID-Nummern unterscheidet sich in den EU-Mitgliedsstaaten. Nähere Informationen sind daher bei der zuständigen Behörde in dem jeweiligen EU-Mitgliedsstaat einzuholen.
Das Handbuch setzt Kenntnisse über die Architektur und Benutzung der DLE voraus. Hier werden nur die Erweiterungen im Rahmen der UID- Prüfung beschrieben.

Die Definition der zur UID-Prüfung nötigen Kommandos und Datenstrukturen sind in dem DLE Paket UID zusammengefaßt.

Für die Verwendung des UID Paketes werden folgende Dateien benötigt.
Das Verzeichnis ist relativ zum DLE Installationsverzeichnis.

Im Verzeichnis packages/UID/lib befinden sich alle benötigten Bibliotheken für die Verwendung des UID Paketes.

Die Prüfung von UID-Nummern wird durch einen Webservice durchgeführt. Dieser muss konfiguriert werden, bevor die UID-Prüfung genutzt werden kann. Dazu wird ein neuer Service in der DLE Session Konfiguration definiert und mit entsprechenden Parametern versehen:

<Service name="UidWebService" class="at.visionflow.dle.uid.DLEUidWebService">
<Properties>
<!-- AT-UID-Service - configuration -->
<Property name="AT_UidSessionServiceName"
value="SessionWSIService" />
<Property name="AT_UidSessionServiceAddress"
value="https://finanzonline.bmf.gv.at:443
/fon/services/SessionWSI" />
<Property name="AT_UidSessionPortType"
value="SessionWSI" />
<Property name="AT_UidCheckServiceName"
value="uidAbfrageService" />
<Property name="AT_UidCheckServiceAddress"
value="https://finanzonline.bmf.gv.at:443
/fon/ws/uidAbfrageService" />
<Property name="AT_UidCheckPortType"
value="uidAbfrage" />
<!-- DE-UID-Service - configuration -->
<Property name="DE_UidSessionServiceAddress"
value="http://evatr.bff-online.de
/evatrRPC" />
</Properties>
</Service>

Name und Klasse des Services sind dabei fix vorgegeben. Zu diesem Service gibt es mehrere konfigurierbare Parameter, die den Zugriff auf den Service steuern für den jeweiligen EU-Mitgliedsstaat steuern. Je nachdem von welchem Land aus die Anfrage gemacht wird sind nur die jeweiligen länderspezifischen Parameter erforderlich. Derzeit beschränkt sich der Service auf die EU-Mitgliedsstaaten Deutschland und Österreich. D.h. die Prüfung von UID-Nummern muss aus einem dieser beiden Staaten erfolgen.

Damit das UID Paket im Brickeditor verwendet werden kann, muss das Paket in die Paketliste der DLE Session Konfiguration aufgenommen werden, sofern eine Einschränkung auf bestimmte Pakete gemacht wird (vgl. Benutzerhandbuch). Dazu ist das Paket UID im Parameter ListOfPackages hinzuzufügen:

<Property name="ListOfPackages" value="BASE;DPE;DLE;UID"/>

Die Paketliste ist eine durch Semikolon getrennte Aufzählung der Pakete, die im Brickeditor zur Verfügung stehen.

Das UID Paket definiert einige neue Kommandos und Datenstrukturen, die für die UID-Prüfung verwendet werden können.

Geprüft werden UID-Nummern, indem ein vordefinierter Daten (können je nach EU-Mitgliedsstaat variieren) durch die DLE an die jeweilige Behörde des Antragstellerlandes übergeben wird. Dabei sind in Abhängigkeit der verschiedenen EU-Mitgliedsstaaten spezifische Anfragedaten erforderlich. Auch die Antworten unterscheiden sich in dieser Hinsicht und müssen länderspezifisch differenziert ausgewertet werden. Die DLE bietet daher für unterschiedliche Länder verschiedene Kommandos an. Diese sind im Nachfolgenden im Detail beschrieben.

Das Ergebnis der Prüfung wird länderunabhängig in ein Datenobjekt vom Typ „UID_PRÜFERGEBNIS“ geschrieben. Das Datenobjekt enthält folgende Felder die je nachdem bei Abfragen von einem oder mehreren Ländern gesetzt werden.

Für die Attribute Name_Ergebniscode, Ort_Ergebniscode, Plz_Ergebniscode und Strasse_Ergebniscode sind folgende Codes möglich:
A = stimmt überein
B = stimmt nicht überein
C = nicht angelegt
D = vom EU-Mitgliedsstaat nicht mitgeteilt

Die Adresszeilen werden für Prüfungen aus Österreich von der Behörde befüllt. Für Prüfungen aus Deutschland werden die Daten in diese Zeilen geschrieben, die an die zuständige Behörde geschickt werden.