Leitfaden · 2026-08-29
Markdown-ExportProgrammatischer Umgang mit E-Rechnungs-Schemafehlern
Werten Sie Validierungsfehler aus, finden Sie strukturelle XML- und Namespace-Probleme und wenden Sie nur durch Quellen belegte Korrekturen an.
Analysieren der Validierungs-Payload
Wenn eine Rechnung die Schemavalidierung nicht besteht, gibt die API strukturierte JSON-Fehler statt konvertierter XML-Daten zurück. Ordnen Sie bekannte Fehlercodes Feldern zu, ändern Sie einen Wert aber nur mit Beleg aus freigegebenen Quellen oder Stammdaten. Leiten Sie unklare oder wesentliche Änderungen an eine Person zur Prüfung weiter.
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 bei fehlender
BuyerReferenceden Wert für diesen Auftrag aus freigegebenen Kunden- oder Auftragsdaten. Wenn er fehlt, fragen Sie den Käufer; setzen Sie keine Standard-Leitweg-IDein. - 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
- Wiederholen Sie automatisch nur nach einem zeitweiligen Verbindungs- oder Rate-Limit-Fehler oder nach einer eindeutigen, durch Quelldaten bestätigten Korrektur.
- Manuelle Prüfung: Erforderlich, wenn sich die Summen erheblich unterscheiden, Bankverbindungen fehlen oder Steuerkategorien unklar sind.