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) 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
C62und markiert sie zur Prüfung; bestätigen Sie vor der Übernahme, dass die markierte Einheit mit der Originalrechnung übereinstimmt.
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.