# Leitfaden zur behördlichen E-Rechnungsvalidierung

Beheben Sie behördliche Validierungswarnungen, verwalten Sie Verbindungs-Timeouts, interpretieren Sie KoSIT-Validierungsberichte und stellen Sie die Konformität mit `EN16931` sicher.

## Behördliche Validierung verstehen

Während lokale Validierungstools die grundlegende Struktur überprüfen, erfordert die offizielle E-Rechnungskonformität das Bestehen der behördlichen Validierung. Dies umfasst die Ausführung offizieller Schematron-Regeln des KoSIT-Validators für deutsche Standards oder der Peppol BIS Billing 3.0-Spezifikationen.

Das Bestehen dieses Schritts liefert den rechtlichen Nachweis, dass das generierte `UBL`- oder `CII`-XML den europäischen Standards entspricht.

## Umgang mit temporären Ausfällen

- Der KoSIT- oder Peppol-Webdienst startet gerade oder ist wegen Wartungsarbeiten offline.
- Netzwerklatenz führt zu Verbindungs-Timeouts zwischen dem Gateway und den offiziellen Servern.
- Zeiten mit hohem Datenverkehr führen zu temporären `504 Gateway Timeout`-Antworten.

## Resilienz-Richtlinie für Entwickler

Wenn der behördliche Validierungsdienst nicht erreichbar ist, gibt Invoice Converter einen `VALIDATION_SERVICE_UNAVAILABLE`-Fehler zurück.

In Produktionsumgebungen sollten Sie diesen Status abfangen und die Rechnung in eine Warteschlange für erneute Versuche (Retry-Queue) einreihen. Überspringen Sie niemals die Validierung für Käufer im öffentlichen Sektor (z. B. solche, die eine `Leitweg-ID` erfordern), da diese nicht validierte Rechnungen ablehnen.

## Fehlerbehebung bei Validierungsfehlern

- Überprüfen Sie, ob die `BuyerReference` oder `Leitweg-ID` dem offiziellen Registerformat entspricht.
- Stellen Sie sicher, dass Währungscodes dem Standard ISO 4217 entsprechen.
- Stellen Sie sicher, dass die Steuer-Zwischensummen exakt mit der Summe der Steuerwerte der einzelnen Rechnungsposten übereinstimmen.
- Prüfen Sie den zurückgegebenen XML-Bericht in der Antwort-Payload auf exakte Schematron-Regel-IDs wie `BR-DE-15`.