Zum Hauptinhalt springen

Änderungsanträge stellen

Änderungen am Standard XBezahldienste werden als Change Requests (CR) über GitLab-Issues eingereicht. Damit ein Antrag von der Expertengruppe bewertet und abgenommen werden kann, muss er genau einem Typ zugeordnet sein: Ein abnahmereifer Änderungsantrag trägt entweder das Label Fachlich oder das Label Technisch – niemals beide.

Diese Seite hilft Ihnen, den richtigen Antragstyp zu erkennen und den passenden Einreichungsweg zu wählen.

Fachlicher Änderungsantrag​

Die Änderung betrifft die fachlichen Werte, Inhalte oder Regeln des Standards, also was im Standard beschrieben wird und welche Bedeutung es hat. Dazu zählen auch rechtliche und normative Vorgaben (Gesetze, Verordnungen, Normen wie ISO), die verbindlich festlegen, welche Inhalte oder Formate zu verwenden sind. Die Bewertung erfordert fachliches Expertenwissen (z. B. Buchhaltung, Verwaltungsrecht, Steuerrecht, regulatorische Vorgaben).

Ein Antrag ist fachlich, wenn er die inhaltliche Ausgestaltung verändert: welche Informationen übertragen werden, welche Werte oder Codes zulässig sind, welche fachlichen Regeln gelten oder wie ein Bezahlvorgang ablaufen soll. Solche Änderungen haben eine spürbare Auswirkung auf die Praxis und lassen sich ohne technisches Spezialwissen beurteilen.

Technischer Änderungsantrag​

Die Änderung betrifft die technische Umsetzung des Standards als OpenAPI-Spezifikation, also wie bereits feststehende fachliche Vorgaben in der Spezifikation korrekt, widerspruchsfrei und OpenAPI-konform beschrieben werden. Die fachliche Bedeutung, die erlaubten Inhalte und die erforderliche Gestalt der Werte bleiben dabei unverändert. Die Bewertung erfordert technisches Expertenwissen (z. B. API-Design, OpenAPI, semantische Versionierung, Implementierung).

Für die Praxis in der Verwaltung ändert sich durch einen technischen Antrag inhaltlich nichts. Es geht ausschließlich um die widerspruchsfreie und konsistente Beschreibung an allen Stellen, die Korrektheit von Prüfregeln und Beispielen, die Konformität mit den OpenAPI-Grundsätzen und Konventionen des Standards sowie um technische Robustheit und Abwärtskompatibilität.

Ein Typ pro Antrag​

Pro Änderungsantrag gilt genau ein Typ: Ein abnahmereifer Antrag ist eindeutig entweder als Fachlich oder als Technisch klassifiziert – nie als beides zugleich.

Betrifft ein Anliegen sowohl fachliche als auch technische Aspekte, teilen Sie es in zwei separate Änderungsanträge auf, die jeweils eigenständig entscheidbar sind.

So reichen Sie ein​

Reichen Sie den Antrag als GitLab-Issue im Repository des Standards über die zum Typ passende Issue-Vorlage ein:

Jede Vorlage fragt dieselben Angaben ab: die Version des Standards, auf die Sie sich beziehen, eine User-Story (Wer möchte was, und zu welchem Zweck?), den Sachverhalt sowie die konkrete fachliche bzw. technische Anforderung. Beim technischen Antrag können Sie zusätzlich einen optionalen Vorschlag zur Spezifizierung anhand der bestehenden OpenAPI ergänzen.