Version

1.0.0

Zustellungskanal (OSCI/XTA)

Bemerkung: Dieser Parameter ist nur vorhanden, wenn es einen OSCI/XTA-basierten Zustellungskanal gibt. Er besteht aus mehreren Bestandteilen, die in verschiedenen Systemen gepflegt werden und daher über verschiedene APIs ermittelt werden müssen.

Konkret sind dies

• Der organizationKey für die Nutzung der DVDV-API zur Ermittlung von weiteren technischen Adressierungsinformationen. Der organizationKey kann aus dem PVOG ermittelt werden (vgl. auch Best Practices).
• Die weiteren Adress- und Zertifikat-Informationen für die Adressierung und die kryptografische Absicherung beim Versand des Antrags über den Zustellkanal OSCI/XTA. Diese Informationen können aus dem DVDV ermittelt werden.

Fachliche Kategorie	Technische Kategorie
Parameter mit Bezug zum Antrags-Versand	XZuFi-basierte Parameter ohne direkten Onlinedienst-Bezug + DVDV-basierter Parameter

Fachliche Bedeutung

Die Adress- und Zertifikat-Informationen, die bei Benutzung des OSCI/XTA-Transportdienstes verwendet werden müssen, um den korrekten Adressaten ansprechen und mit ihm kommunizieren zu können.

Wertemenge

• organizationKey: Zeichenkette
• weiteren Adress- und Zertifikat-Informationen: verschiedene DVDV-DienstElemente

Bemerkung: Die Verwendung der DVDV-DienstElemente muss für jeden Onlinedienst individuell geklärt werden. In der Regel sollte die Nutzung der verschiedenen DienstElemente wie z.B. OSCI-Intermediär, OSCI-Empfänger, Signaturzertifikat und Verschlüsselungszertifikat im jeweiligen DVDV-Eintragungskonzept und der weiteren DVDV-Dienst-Dokumentation geregelt sein.

Verortung im Datenmodell

XZuFi / PVOG

Die zuständige Organisationseinheit enthält ein oder mehrere Elemente Kommunikationssystem. Eines dieser Elemente enthält im Element kanal den Wert "006" (Bezeichnung "System mit OSCI-Schnittstelle")¹ UND im Element kennungZusatz einen bestimmten, Leistungs-spezifischen Wert. Dieser Wert ist die serviceSpecificationUri, die im DVDV-Eintragungskonzept festgelegt wurde und den Dienst der Leistung repräsentiert. In diesem Kommunikationssystem-Element enthält das Element kennung den Wert des organizationKey.

DVDV

Im DVDV gibt es eine Organisation, die den Anbieter der Leistung (i.e. die zuständige Organisationseinheit) repräsentiert. Diese Organisation ist mit einem oder mehreren DienstElementen und dem Dienst verknüpft, der durch die oben genannte serviceSpecificationUri identifiziert ist. Diese DienstElemente enthalten die gesuchten Informationen. Details sind dem jeweiligen DVDV-Eintragungskonzept und der weiteren DVDV-Dienst-Dokumentation zu entnehmen.

Ermittlungsmöglichkeit PVOG API

Hinweis: Zur Ermittlung des OrganizationKey kann die PVOG-API genutzt werden (vgl. auch Best Practices). Die PVOG-API kann nicht für die Ermittlung der weiteren Adress- und Zertifikats-Informationen genutzt werden.

Zunächst muss der Onlinedienst das zuständige Organisationseinheit-Datenobjekt mit Hilfe der PVOG-API ermitteln.

Der Onlinedienst ermittelt dann den Wert für die serviceSpecificationUri aus seiner überregional-gültigen Konfiguration.

Die Response, die der Endpunkt /v1/organisationunits/jzufi zurückgibt, enthält ein Element kommunikationssystem[], das die Kommunikationssysteme der Organisationseinheit enthält. Der Onlinedienst muss dasjenige kommunikationssystem-Element identifizieren, das die folgenden Bedingungen erfüllt:

• kommunikationssystem[].gueltigkeit[] ist leer oder enthält mindestens ein Objekt mit den Elementen beginnund ende, das den gewünschten Zeitpunkt umschließt
• kommunikationssystem[].kanal.code = "006"
• kommunikationssystem[].kennungZusatz = <die zuvor ermittelte serviceSpecificationUri>

Das so identifizierte kommunikationssystem-Element enthält dann im Element kommunikationssystem[].kennung den Wert des OrganizationKey.

Hinweis

Es ist denkbar, dass es in einzelnen Ländern Redaktionssysteme gibt, die es nicht erlauben, das Feld kennungZusatz zu pflegen oder die Pflege dieses Feldes kann ggf. vergessen werden. Der Onlinedienst bzw. dessen Plattform kann gegenüber diesem Problem fehlertolerant gebaut werden.

Sollte die oben dargestelle Suche nach dem passenden kommunikationssystem kein Ergebnis liefern, weil keines der gefundenen kommunikationssysteme die serviceSpecificationUri als kennungZusatz trägt, so kann der Onlinedienst noch das Folgende versuchen: Er filtert alle kommunikationssysteme der Organisationseinheit wie zuvor nach gueltigkeit und kanal aber zusätzlich nach leerem kennungZusatz. Diese Filterung kann mehrere Ergebnisse liefern. Nun muss er versuchen, mit jeder kennung (i.e. OrganizationKey), die er in einem der herausgefilterten kommunikationssysteme gefunden hat, und der serviceSpecificationUri im DVDV nach Adressdaten zu suchen. In genau einem Fall sollte er dabei ohne Fehlermeldung erfolgreich sein.

info

In XZuFi 2.3 wird das Element Kommunikationssystem nicht mehr direkt der Organisationseinheit, sondern deren Zustaendigkeit für eine Leistung und einer gebietID (i.e. ARS) zugeordnet sein. Damit sollte es dann dort auch nur noch für jeden Gültigkeitszeitpunkt genau ein Kommunikationssystem-Element geben, für das kommunikationssystem[].kanal.code = "006". Aus diesem kann dann der zu verwendende Wert für serviceSpecificationUri aus dem Element kennungZusatz ausgelesen werden. Die Notwendigkeit für eine überegional-gültige Konfiguration und die Nutzung des Wertes als Diskriminator wird dann entfallen.

Ermittlungsmöglichkeit FIT-Connect Routing API

(Der Parameter kann nicht über das FIT-Connect Routing API ermittelt werden.)

Ermittlungsmöglichkeit DVDV API

Hinweis: Die DVDV-API kann und muss zur Ermittlung der weiteren Adress- und Zertifikat-Informationen genutzt werden. Zuvor muss die PVOG-API für die Ermittlung des OrganizationKey genutzt werden (vgl. auch Best Practices), wofür die DVDV-API selbst nicht genutzt werden kann.

Zunächst ermittelt der Onlinedienst den Wert der serviceSpecificationUri aus seiner Konfiguration und ermittelt damit den Wert des OrganizationKey mit Hilfe der PVOG-API.

Mit diesen Informationen benutzt der Onlinedienst dann die Methode findServiceDescription der DVDV-API-Bibliothek und ruft damit indirekt den Endpunkt /{entryPath}/findservicedescription mit den Parametern <organizationKey> und <serviceSpecificationUri> auf - siehe Dokumentation der DVDV-API.

Über das ServiceDescription-Rückgabeobjekt der Bibliotheksfunktion kann der Onlinedienst mittels getServiceElements() die Liste der DienstElemente ermitteln. Aus dieser Liste wählt er diejenigen DienstElemente aus, die laut DVDV-Eintragungskonzept und und der weiteren DVDV-Dienst-Dokumentation die gesuchte Informationen enthalten und wertet diese aus.

Best Practices

Der Onlinedienst kann bis zur Migration nach XZuFi 2.3 den Wert für ServiceSpecificationUri nicht über einen Auskunftsdienst ermitteln, sondern muss ihn selber "kennen". Dafür sollte der Onlinedienst eine Konfigurationsmöglichkeit der IT-Betriebsplattform des Onlinedienstes nutzen. Die Konfiguration ist zwar spezifisch für die jeweilige Leistung, die der Onlinedienst unterstützt, aber gilt regional unbeschränkt und wird sich voraussichtlich höchstens sehr selten ändern, so dass ein einfacher Konfigurationsmechanismus genutzt werden kann.

Das hier standardisierte Verfahren, den organizationKey aus dem PVOG-Element Kommunikationssystem zu ermitteln ist Stand Q2/2024 unüblich. So gibt es auch andere Ansätze, den OrganizationKey zu bestimmen. Einer dieser Ansätze ist, anhand der vorhandenen Information des Antrags - insbesondere des ARS bzw. AGS der Antragstellung - und der im DVDV-Eintragungskonzept dokumentierten Regel der Konstruktion der OrganizationKeys, den gesuchten Schlüssel durch den Onlinedienst selbst "nachbauen" zu lassen. Ein solches Verfahren ist riskant, da nicht immer gewährleistet ist, dass diese "Schlüssel-Rekonstruktion" erfolgreich ist bzw. den Schlüssel der richtigen Organisationseinheit erzeugt. So ist es denkbar, dass einer Organisationseinheit im DVDV ein AGS auf der Basis ihrer geografischen Verortung ihres Sitzes zugeordnet wurde, der Antrag sich aber auf eine andere Region bezieht, für die die Organisationseinheit trotzdem zuständig ist. Zum Beispiel sind alle Oberlandesgerichte eines Bundeslandes für die Beantragung des Juristischen Vorbereitungsdienstes (i.e. Rechtsreferendariat in der Juristenausbildung) zuständig. Jedem OLG sind dabei einige Landgerichte zugeordnet, an denen der Juristische Vorbereitungsdienst operativ stattfindet, wobei die Zuordnung aber nicht streng der Hierarchie der ARS folgt. Wie soll in einem solchen Fall der Organisationsschlüssel für das gewünschte OLG prozesssicher (re-)konstruiert werden?

Footnotes

1. Diese Festlegung ist ein Vorgriff auf XZuFi 2.3: In XZuFi 2.2 ist die Code-Liste für das Element kanal als Typ-4-Codeliste (i.e. ohne festen Wertebereich) definiert. Um eine Standardisierung zu erreichen, bezieht sich die hier gemachte Festlegung bereits auf die Code-Liste urn:xoev-de:fim:codeliste:xzufi.kommunikationssystemtyp, die für das Entsprechende Element in XZuFi 2.3 vorgesehen ist. ↩