# Programmatischer Umgang mit E-Rechnungs-Schemafehlern

- Aktualisiert im Mai 2026

Analysieren Sie Validierungsfehler-Arrays, beheben Sie strukturelle XML-Probleme, behandeln Sie `UBL`-/`CII`-Namespace-Konflikte und automatisieren Sie Korrekturen programmatisch.

## Analysieren der Validierungs-Payload

Wenn eine Rechnung die Schema-Validierung nicht besteht, gibt die API ein strukturiertes JSON-Payload mit einer detaillierten Fehlerliste anstelle einer konvertierten XML-Datei zurück. Der programmatische Umgang ermöglicht es Ihrem System, einfache Probleme automatisch zu beheben oder komplexe Fehler an menschliche Prüfer weiterzuleiten.

Die Fehlerantwort enthält einen `VALIDATION_FAILED`-Statuscode zusammen mit einem Array von Fehlerobjekten. Jedes Objekt liefert einen spezifischen Pfad zum fehlerhaften Feld, den Wert, der den Fehler verursacht hat, und eine verständliche Beschreibung der verletzten Compliance-Regel (z. B. `BR-CO-13`).

## Automatisierung gängiger Lösungen

- Bei einer fehlenden `BuyerReference` fragen Sie Ihre Kundendatenbank nach der Standard-`Leitweg-ID` ab und versuchen es erneut.
- Bei Rundungsabweichungen (z. B. Differenzen beim `PayableAmount`) prüfen Sie das Quelldokument und korrigieren die zugrunde liegenden Positionsbeträge oder USt-Werte; übernehmen Sie nur Werte, die mit der Rechnung übereinstimmen.
- Bei einem fehlenden Einheiten-Code setzt Invoice Converter für die Position standardmäßig `C62` und markiert sie zur Prüfung; bestätigen Sie vor der Übernahme, dass die markierte Einheit mit der Originalrechnung übereinstimmt.

## Erneuter Versuch vs. manuelle Eskalation

- Automatischer Retry: Sicher bei temporären Verbindungsfehlern, Ratenbegrenzungen oder schnellen Schema-Korrekturen.
- Manuelle Prüfung: Erforderlich, wenn sich die Summen erheblich unterscheiden, Bankverbindungen fehlen oder Steuerkategorien unklar sind.