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 ("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 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 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!