X.Justiz.Core

X.Justiz Core

[!TIP]
🌐 English version available here 👈

X.Justiz Core ist ein leichtgewichtiges Schema für den Datenaustausch zwischen Softwarelösungen im rechtlichen Ökosystem. Er basiert auf dem etablierten X.Justiz-Standard und optimiert diesen für die außergerichtliche Kommunikation und moderne LegalTech-Szenarien.

Inhaltsverzeichnis

• Hintergrund
• Motivation
• Ziele & Vorteile
• X.Justiz Kompatibilität
• Herausragende Merkmale & Verbesserungen
• Nutzung von Codes
• Implementierung (SDKs)
• Spezifikation
• Beispieldaten
• Entwickler-Ressourcen

[!NOTE]
📘 Suchen Sie nach technischen Details?
Springen Sie direkt zur Spezifikation für X.Justiz Core für Datenmodell-Dokumentation, Code-Beispiele und Best Practices.

Hintergrund

Die „Arbeitsgruppe Schnittstellen” des LegalTech Verband Deutschland entwickelte 2024 diesen Standard, um den Austausch von Rechtsangelegenheiten (Akten) effizienter zu gestalten.

Als Basis dient der offizielle X.Justiz-Standard, da dieser der etablierte Maßstab im elektronischen Rechtsverkehr (ERV) ist und von der Bund-Länder-Kommission (BLK-AG IT-Standards) gepflegt wird.

[!IMPORTANT]
Wir freuen uns auf Ihre Beteiligung! Ob Fragen, Anregungen, Fehlermeldungen oder Mitwirkung am Standard – wir laden alle Nutzer ein, sich aktiv einzubringen. Besuchen Sie unsere Diskussionen: 👉 GitHub Discussions

Motivation

Der klassische X.Justiz-Standard ist funktionsreich, jedoch für den schnellen Austausch zwischen privaten Marktteilnehmern oft zu komplex. X.Justiz Core adressiert folgende Punkte:

• Reduzierte Komplexität: Beschränkung auf eine praxisrelevante Teilmenge, um „Noise” im Datenaustausch zu vermeiden.
• Moderne Technik: Unterstützung von Dokumentenübertragungen via Pre-Signed URLs und Format-Agnostik (optimiert für JSON und XML).
• Zugänglichkeit: Zweisprachige Dokumentation (Deutsch/Englisch) für internationale Entwicklerteams.
• Erweiterung: Einführung neuer Schlüssel für Rechtsangelegenheiten (z.B. Erbrecht, Verkehrsrecht, Mietrecht).
• Flexibilität: Flexible Übermittlung von Sachverhalten, für die bisher keine spezifischen Schlüssel in X.Justiz existieren.

Ziele & Vorteile

Das Ziel von X.Justiz Core ist eine effiziente Interoperabilität:

• Effizienz: Reduzierung des Aufwandes für individuelle Schnittstellen zwischen Software-Anbietern.
• Innovation: Schnelle Anbindung von Marktplätzen und spezialisierten LegalTech-Produkten.
• Praxisnähe: Spezifische Erweiterungen für gängige Rechtsgebiete wie Erbrecht, Verkehrsrecht oder Mietrecht.
• Open Source: Kostenfreie Bereitstellung zur Förderung eines vernetzten Ökosystems.

Mit entsprechenden Kompatibilitätseinbußen können X.Justiz Core-Daten auch mit älteren Versionen (bis 2.1.0) kompatibel verwendet werden.

Herausragende Merkmale & Verbesserungen

X.Justiz Core fungiert als moderne Brücke zwischen dem offiziellen Standard und den Bedürfnissen privater Marktteilnehmer:

• Etablierte Basis: Basiert auf dem offiziellen X.Justiz-Standard, der für deutsche Legal Tech- und Justiz-Kommunikation obligatorisch ist.
• Optimierte Dokumentation: Entwicklerzentrierte Dokumentation in Deutsch und Englisch, was die Einarbeitungszeit für internationale Teams verkürzt.
• Gebrauchsfertige SDKs: Vollständige Klassenbibliotheken und Codelisten-Mappings für .NET und Java, was das manuelle XML/JSON-Parsing überflüssig macht.
• Erweiterte Codelisten: Einbeziehung eigener Codelisten für Bereiche, die nicht durch den Standard abgedeckt sind (z. B. Versicherer, Versicherungstyp).
• Unabhängiger Dokumenttransfer: Konzept für die unabhängige Übertragung von Dokumenten und Anhängen von der Hauptnachricht (z. B. über Pre-Signed URLs).
• Detaillierter Sachverhalt: Zusätzliche Eigenschaften zur Beschreibung des Sachverhalts, zugeschnitten auf die Anforderungen im Legal Tech.
• Flexibles Datenkonzept: Erweiterte Möglichkeiten zur Übertragung generischer oder fachspezifischer Daten durch ein verbessertes Feld / Feldgruppe Konzept.

Nutzung von Codes

In X.Justiz Core werden Fachdaten (wie Staaten, Rollen oder Gerichte) über standardisierte Codes /Schlüssel identifiziert. Dies gewährleistet eine maschinenlesbare Eindeutigkeit über Systemgrenzen hinweg.

Herkunft und Verwaltung

Die meisten Codelisten werden zentral vom XRepository bereitgestellt. Jede Liste ist über eine eindeutige URI und eine spezifische versionlistid identifizierbar. Dies ermöglicht es, Änderungen an den Katalogen (z.B. neue Staaten oder geänderte Rollenbezeichnungen) präzise zu tracken. Bspw.:

Entität	Versionlistid	Quelle
Staat	2024-08-01	XRepository
Staat	2023-02-24	XRepository
…	…	…

Anwendung im Datenaustausch

In einigen Code Listen gibt es Mehrfachdefinitionen für die einzelnen Codes. In der Code-Liste “Staat” gibt es bspw. den Eintrag für “Deutschland” mit folgenden Werten:

Merkmal	Wert
Schlüssel (Staat)	000
Suchbegriff	Deutschland
Kurzname	Deutschland
Vollständiger Name	die Bundesrepublik Deutschland
Staatsangehörigkeit	deutsch
ISO-Alpha-3	DEU
ISO-Alpha-2	DE

Obwohl primär der technische Code (z.B. 000 für Deutschland) verwendet werden sollte, ist laut X.Justiz auch die Verwendung der Alternativrepräsentationen (z.B. Deutschland, DE, DEU, usw.) erlaubt. X.Justiz Core unterstützt auch das Empfangen / Lesen der entsprechenden Alternativrepräsentationen und können diese intelligent mappen, um eine maximale Flexibilität bei der Implementierung zu gewährleisten.

Wir legen dennoch nahe, primär die Codes (z.B. 000 für Deutschland) zu verwenden. Die SDKs verwenden beim Senden / Schreiben der Daten automatisch die technische Codes.

Um Entwicklern die Arbeit zu erleichtern, haben wir alle relevanten Kataloge direkt in unsere SDKs integriert. Heute sind es 3.397 Codes in 26 verschiedenen Versionlisten aus 8 Haupt-Codetypen (Staat, Rolle, Gericht, Dokumentklasse, etc.).

X.Justiz Core Erweiterungen

Zusätzlich zu den standardmäßigen X.Justiz-Katalogen haben wir eigene Codelisten erstellt, um moderne LegalTech-Szenarien zu unterstützen, in denen der Standard keine spezifischen Schlüssel bietet. Dies umfasst:

• Versicherer: Eine umfassende Liste von Versicherern (BaFin-basiert).
• Versicherungstyp: Definitionen für verschiedene Arten des Versicherungsschutzes.

Diese Listen sind als stark typisierte Enums vollständig in die SDKs integriert. Eine vollständige Liste der verfügbaren Codes und deren Verwendung finden Sie in der Datenmodell-Referenz in der Spezifikation.

Wir haben besonderen Wert auf die Entwicklereffizienz gelegt: Die SDKs enthalten umfassende Klassenbibliotheken für diese Codes, die mit deutschen und englischen Übersetzungen direkt im Quellcode optimiert wurden. Dies macht die Entwicklung extrem schnell, da moderne IDEs die Dokumentation und Bedeutung in beiden Sprachen über IntelliSense anzeigen.

Implementierung (SDKs)

Um die Einbindung zu beschleunigen, stellt das Projekt Softwarebibliotheken bereit.
Sie beinhalten:

• Klassenbibliothek
• Utility-Tools
• Code Listen (X.Justiz & X.Justiz Core)

Die SDKs sind in folgenden Sprachen verfügbar:

• ✅ .NET Code

  nuget Paket

  Erste Schritte

• ✅ Java

  Maven Paket

  Erste Schritte

• ⏳ JavaScript / TypeScript (In Arbeit)
• ⏳ Python (In Arbeit)

Spezifikation

X.Justiz Core

• Spezifikation für X.Justiz Core - Umfassende Datenmodell-Dokumentation
• Validierungsregeln als XSD
• Listen verwendeter Codes
• Änderungshistorie
• Lizenz

X.Justiz

• Archiv aller X.Justiz Versionen und Spezifikationen

Beispieldaten

Testdaten und Szenarien stehen zur Verfügung, um Ihre Implementierung zu testen:
Beispieldaten

Enthält Beispiele für:

• Arbeitsrecht
• Erbrecht
• Verkehrsrecht
• Mietrecht
• Und mehr…

Entwickler-Ressourcen

• 🔧 SDK-Generierungs-Workflow - Wie die SDK-Konsistenz gewährleistet wird
• 🧪 Integrationstests - Plattformübergreifende Kompatibilitätstests

This site is open source. Improve this page.