Leitfaden · Aktualisiert im Mai 2026
Markdown-ExportProgrammatischer Umgang mit E-Rechnungs-Schemafehlern
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
Nutzen Sie diese Punkte als praktische Prüfschritte für diesen Abschnitt.
- Bei einer fehlenden
BuyerReferencefragen Sie Ihre Kundendatenbank nach der Standard-Leitweg-IDab und versuchen es erneut. - Bei Rundungsabweichungen (z. B. Differenzen beim
PayableAmount) wenden Sie automatisch eine geringfügige Rundungsanpassung von bis zu 0,02 Währungseinheiten an. - Ordnen Sie ungültige Einheiten-Codes (wie die Verwendung von PCE anstelle des Standards
C62) vor dem Senden programmatisch zu.
Erneuter Versuch vs. manuelle Eskalation
Nutzen Sie diese Punkte als praktische Prüfschritte für diesen Abschnitt.
- 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.