Version

1.0.0

Rechtsgrundlagen

Fachliche Kategorie	Technische Kategorie
Stammdaten der Leistung	XZuFi-basierte Parameter ohne direkten Onlinedienst-Bezug

Fachliche Bedeutung

Rechtsgrundlagen

Wertemenge

Eine komplexe Datenstruktur Textmodul, die die folgenden Elemente enthält:

• inhalt: ein internationalisierter Text,
• leikaTextmodul: der Code "07" aus der Code-Liste urn:de:xzufi:codeliste:leistungstextmodulleika (öffnet in neuem Tab) ("Handlungsgrundlage(n)"/"Basis for legal action") zur Festlegung der Kategorie des Textmoduls als Informationen zu den Rechtsgrundlagen
• leikaTextmodulAbweichendeBezeichnung: eine internationalisierte abweichende Bezeichnung und
• weiterfuehrenderLink: ein oder ggf. mehrere Links zu weiteren Informationen in Form einer internationalisierte Datenstruktur HyperlinkErweitert.

Für eine detaillierte Darstellung dieser Datenstruktur wird hier auf die XZuFi-Dokumentation (öffnet in neuem Tab) verwiesen.

Verortung im Datenmodell

Die Rechtsgrundlagen werden in einem optionalen Element modulText, das Teil des Elements Leistung ist, abgelegt und mit dem Code "07" aus der Code-Liste urn:de:xzufi:codeliste:leistungstextmodulleika (öffnet in neuem Tab) gekennzeichnet.

Codebeispiel XZuFi 2.2

info

• Das folgende Codebeispiel zeigt nicht alle Features des modulText-Elements.

    <xzufi:leistung>

      <xzufi:modulText>
        <xzufi:positionDarstellung>5</xzufi:positionDarstellung>
        <xzufi:inhalt languageCode="de">§ 15 Absatz 1 - 3 und 5 Bundesjagdgesetz (BJagdG)</xzufi:inhalt>
        <xzufi:inhalt languageCode="en">§ 15 paragraphs 1 - 3 and 5 Federal Hunting Act (BJagdG)</xzufi:inhalt>
        <xzufi:leikaTextmodul listURI="urn:de:xzufi:codeliste:leistungstextmodulleika" listVersionID="20201201">
          <code>07</code>
        </xzufi:leikaTextmodul>
      </xzufi:modulText>
      
    </xzufi:leistung>

Ermittlungsmöglichkeit PVOG API

Zunächst ermittelt der Onlinedienst die Daten der Leistungsbeschreibung.

In der Response findet sich ein Element modulText[] das Informationen zu verschiedenen Kategorien enthält. Aus diesen Elementen muss der Onlinedienst dasjenige auswählen, bei dem das Element modulText[]:leikaTextmodul:code den Wert 07 enthält und dessen Element modulText[]:gueltigkeit[] leer ist oder mindestens ein Objekt enthält, dessen beginn und ende-Elemente den gewünschten Zeitpunkt umschließen.

Das so identifizerte modulText-Element enthält dann die Rechtsgrundlagen.

Ermittlungsmöglichkeit FIT-Connect Routing API

Der Onlinedienst benutzt den Endpunkt /routes mit den URL-Parametern zur Identifikation des gesuchten Adressaten, z.B. leikaKey = <LeikaId der Leistung> und ars = <ARS des gesuchten Gebiets> und erhält eine JSON-Datenstruktur als Response.

In dieser Datenstruktur enthält das Element route[]:legalBasis:description, die Texte aus dem inhalt-Element der XZuFi-Datenstruktur als internationalisierte Zeichenkette. Die Informationen aus den XZuFi-Elementen leikaTextmodulAbweichendeBezeichnung und weiterfuehrenderLink können nicht über die FIT-Connect Routing API ermittelt werden.

gefahr

Stand Q2/2024 wertet die FIT-Connect Routing API die Elemente modulText[]:gueltigkeit[] nicht aus. Es besteht daher das Risiko, dass die API Informationen liefert, die nicht mehr oder noch nicht gültig sind.

Ermittlungsmöglichkeit DVDV API

(Der Parameter kann nicht über das DVDV-API ermittelt werden)

Best Practices

Bezüglich hyperlinkErweitert sind unbedingt die Hinweise zu Internationalisierten Datenstrukturen zu beachten!