Belege-Konfiguration im Überblick und Version veröffentlichen

Die Belege-Konfiguration legt fest, wie Belege validiert werden: die Schwellenwerte, die die Engine verwendet, und den Schweregrad jeder Regel je Beleg-Typ. Konfigurationen sind versioniert — Sie veröffentlichen eine neue Version, um sie zu aktivieren, und Sie können zu einer vorherigen zurückkehren. Dieser Artikel erläutert die Übersicht und den Veröffentlichungsablauf.

Erforderliche Berechtigung

Das Anzeigen der Übersicht, der aktiven Version und des Versionsverlaufs erfordert settings:manage. Das Veröffentlichen und Zurücksetzen erfordert zusätzlich die Rolle SystemAdmin. Öffnen Sie den Bereich unter /admin/belege-configuration.

Was eine Konfiguration enthält

Schwellenwerte — ob die Dublettenerkennung die Rechnungsnummer verwendet, sowie die Toleranz der Kilometerstandsabweichung in Kilometern und Prozent.
Regeln je Beleg-Typ — für jeden Typ der Schweregrad der Kraftstofftyp-Abweichung, der fehlenden Kostenstelle, des fehlenden Mehrwertsteuersatzes, der Dublettenerkennung und der Kilometerstands-Plausibilitätsprüfungen.

Jeder Schweregrad ist einer der Werte Off (Regel deaktiviert), Info, Warning (mit einer Begründung übersteuerbar) oder Blocking (harter Stopp). Mindestens ein Beleg-Typ muss konfiguriert sein.

Die aktive Version prüfen

Öffnen Sie die Konfigurationsübersicht. Sie zeigt die aktuell aktive Version, wann sie veröffentlicht wurde und von wem.
Öffnen Sie den Versionsverlauf, um jede Version zu sehen, welche davon aktiv ist sowie den veröffentlichenden Benutzer und die Trace-Kennung für jede.

Hinweis: Wenn die Übersicht einen 503 mit "Configuration baseline is not available" zurückgibt, wurde das Konfigurationsschema für diese Umgebung nicht bereitgestellt. Veröffentlichung und Zurücksetzung sind ebenfalls blockiert, bis die Baseline vorhanden ist.

Eine neue Version veröffentlichen

Bereiten Sie die Konfiguration vor: Legen Sie die Schwellenwerte und die Schweregrade je Typ fest.
Geben Sie eine Versionsbezeichnung an (erforderlich).
Reichen Sie die Veröffentlichungsanfrage ein.
Bei Erfolg deaktiviert die Plattform die zuvor aktive Version, speichert die neue als aktiv und erfasst ein Veröffentlichungs-Änderungsereignis. Die Antwort gibt die neue Versionskennung und -bezeichnung zurück.

Die Veröffentlichung führt zunächst eine serverseitige Validierung durch: Eine Versionsbezeichnung ist erforderlich, mindestens ein Beleg-Typ muss vorhanden sein, und jeder Schweregrad muss ein anerkannter Wert sein. Ein ungültiger Schweregrad wird mit einer Meldung abgewiesen, die die zulässigen Werte auflistet, sodass ein Tippfehler niemals gespeichert werden kann.

Tipp: Verwenden Sie eine klare, aufsteigende Versionsbezeichnung (zum Beispiel ein Datum oder eine semantische Version), damit sich der Versionsverlauf wie ein Änderungsprotokoll liest.

Zu einer vorherigen Version zurücksetzen

Öffnen Sie den Versionsverlauf und notieren Sie die Kennung der Version, die Sie wiederherstellen möchten.
Reichen Sie eine Zurücksetzung für diese Versionskennung ein.
Die Plattform markiert diese Version wieder als aktiv und erfasst ein Zurücksetzungs-Änderungsereignis.

Eine Zurücksetzung auf eine nicht existierende Version gibt einen Fehler "Version not found" zurück.

Warnung: Die Veröffentlichung wird sofort für alle neuen Regelauswertungen wirksam. Das Anheben einer Regel auf Blocking kann Einreichende mitten im Ablauf stoppen, und das Absenken auf Off deaktiviert eine Prüfung vollständig — überprüfen Sie die Auswirkungen, bevor Sie veröffentlichen.