XRechnung Fehlercodes: Vollständiger Leitfaden zur Fehlerbehebung 2025
In diesem Fehlerleitfaden:
XRechnung-Validierung und Fehlercodes verstehen
Die XRechnung-Validierung erfolgt auf mehreren Ebenen: Schema-Validierung, Business Rules (BR) und deutsche Regeln (BR-DE). Das Verständnis dieser Fehlercodes hilft Ihnen, Probleme vor der Einreichung schnell zu identifizieren und zu beheben.
Fehlercodes folgen einem strukturierten Format:
- BR-XX: Europäische Standard-Geschäftsregeln aus EN 16931
- BR-DE-XX: Deutsche spezifische Geschäftsregeln
- Schema-Fehler: XML-Struktur- und Syntaxverletzungen
- Validierungsfehler: Datenkonsistenz- und Berechnungsprobleme
Business Rule (BR) Fehler - Europäischer Standard
BR-01: Rechnungsnummer erforderlich
Fehlermeldung: "Eine Rechnung muss eine Rechnungsnummer (BT-1) enthalten."
Ursache: Fehlende Rechnungsnummer
Lösung: Eindeutige Rechnungsnummer in Feld BT-1 hinzufügen
Beispiel: <cbc:ID>RE-2025-001234</cbc:ID>
BR-02: Rechnungsdatum erforderlich
Fehlermeldung: "Eine Rechnung muss ein Rechnungsdatum (BT-2) enthalten."
Ursache: Fehlendes oder ungültiges Rechnungsdatum
Lösung: Datum im Format JJJJ-MM-TT hinzufügen
Beispiel: <cbc:IssueDate>2025-01-16</cbc:IssueDate>
BR-04: Rechnungstyp-Code erforderlich
Fehlermeldung: "Eine Rechnung muss einen Rechnungstyp-Code (BT-3) enthalten."
Ursache: Fehlende Rechnungstypangabe
Lösung: Typ-Code hinzufügen (380 für Rechnung, 381 für Gutschrift)
Beispiel: <cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
BR-16: Positionsnettobetrag erforderlich
Fehlermeldung: "Eine Rechnungsposition muss einen Positionsnettobetrag (BT-131) enthalten."
Ursache: Fehlender Nettobetrag für Rechnungsposition
Lösung: Sicherstellen dass jede Position: Menge × Einzelpreis = Positionsnettobetrag
BR-45: MwSt-Kategorie erforderlich
Fehlermeldung: "Jede MwSt-Aufschlüsselung muss einen MwSt-Kategorie-Code (BT-118) enthalten."
Ursache: Fehlende MwSt-Kategorie in Steueraufschlüsselung
Lösung: Passenden MwSt-Kategorie-Code hinzufügen (S, AA, Z, E, etc.)
BR-49: Zahlungsart erforderlich
Fehlermeldung: "Eine Zahlungsanweisung muss den Zahlungsartcode (BT-81) angeben."
Ursache: Fehlende Zahlungsmethodenangabe
Lösung: Zahlungsartcode hinzufügen (30=Überweisung, 59=SEPA)
Deutsche (BR-DE) Fehler
BR-DE-1: Leitweg-ID erforderlich
Fehlermeldung: "Das Element 'Buyer reference' (BT-10) muss übermittelt werden (Leitweg-ID)."
Ursache: Fehlende oder falsche Leitweg-ID für B2G-Rechnungen
Lösung: Exakte Leitweg-ID der Behörde hinzufügen
Kritisch: Muss exakt übereinstimmen, inkl. Bindestriche und Groß-/Kleinschreibung
BR-DE-2: Elektronische Adresse des Verkäufers erforderlich
Fehlermeldung: "Das Element 'Seller electronic address' (BT-34) muss übermittelt werden."
Ursache: Fehlende elektronische Endpoint-ID des Verkäufers
Lösung: PEPPOL-ID oder E-Mail-Adresse als Endpoint hinzufügen
Beispiel: DE:VAT:DE123456789 oder rechnung@firma.de
BR-DE-16: USt-ID bei bestimmten Steuercodes erforderlich
Fehlermeldung: "In der Rechnung muss mindestens eines der Elemente 'Seller VAT identifier' (BT-31) oder 'Seller tax registration identifier' (BT-32) übermittelt werden."
Ursache: Verwendung der Steuercodes S, Z, E, AE, K, G, L oder M ohne USt-ID
Lösung: Umsatzsteuer-Identifikationsnummer des Verkäufers hinzufügen
Format: DE123456789 (Ländercode + Nummer)
BR-DE-19: Zahlungsbedingungen für Skonto
Fehlermeldung: "Die Zahlungsbedingungen (BT-20) müssen die Bedingungen für Skonto spezifizieren."
Ursache: Skontoangebot ohne korrekte Bedingungen
Lösung: Skontoprozentsatz und -frist in Zahlungsbedingungen aufnehmen
Beispiel: "#SKONTO#TAGE=14#PROZENT=2.00#"
Schema-Validierungsfehler
Ungültige XML-Struktur
Fehler: "Der Inhalt des Elements 'Invoice' ist nicht vollständig"
Ursache: Fehlende XML-Elemente oder falsche Reihenfolge
Lösung: Sicherstellen, dass alle Pflichtelemente in korrekter Reihenfolge vorhanden sind
- Namespace-Deklarationen prüfen
- Elementreihenfolge mit Schema abgleichen
- Keine fehlenden schließenden Tags
Ungültiger Datentyp
Fehler: "Ungültiger Inhalt wurde gefunden beginnend mit Element"
Ursache: Falscher Datentyp (z.B. Text in numerischem Feld)
Lösung: Korrekte Datentypen sicherstellen:
- Beträge: Dezimal mit max. 2 Nachkommastellen
- Daten: JJJJ-MM-TT Format
- Codes: Nur gültige Codelistenwerte
Namespace-Fehler
Fehler: "Kann die Deklaration des Elements nicht finden"
Ursache: Fehlende oder falsche Namespace-Deklarationen
Lösung: Korrekte Namespaces für UBL oder CII Syntax überprüfen
UBL: xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
Berechnungs- und Logikfehler
BR-CO-10: Summe der Positionsbeträge Fehler
Fehler: "Summe der Rechnungspositions-Nettobeträge = Rechnungsgesamtbetrag ohne MwSt"
Ursache: Positionen ergeben nicht die Zwischensumme
Lösung: Neu berechnen: Summe aller Positionsnettobeträge muss Rechnungszwischensumme ergeben
Prüfung: Σ(Positionsbeträge) = Rechnungszwischensumme
BR-CO-14: MwSt-Berechnungsfehler
Fehler: "Rechnungsgesamt-MwSt-Betrag = Σ MwSt-Kategoriebeträge"
Ursache: MwSt-Berechnungen stimmen nicht überein
Lösung: MwSt für jede Kategorie korrekt berechnen
Formel: Bemessungsgrundlage × MwSt-Satz = MwSt-Betrag
BR-CO-15: Rechnungssumme Fehler
Fehler: "Rechnungsgesamtbetrag mit MwSt = Rechnungsbetrag ohne MwSt + Gesamt-MwSt"
Ursache: Endsummenberechnung falsch
Lösung: Prüfen: Zwischensumme + Gesamt-MwSt = Endsumme
Format- und Datentypfehler
Datumsformatfehler
Häufige Probleme:
- Falsches Format: Muss JJJJ-MM-TT sein (nicht TT.MM.JJJJ)
- Ungültige Daten: Auf unmögliche Daten prüfen (z.B. 2025-13-32)
- Fehlende führende Nullen: 2025-01-05 verwenden, nicht 2025-1-5
Betragsformatfehler
Häufige Probleme:
- Dezimaltrennzeichen: Punkt (.) verwenden, nicht Komma (,)
- Dezimalstellen: Maximal 2 für Geldbeträge
- Negative Beträge: Minuszeichen verwenden, keine Klammern
Richtig: 1234.56 | Falsch: 1.234,56
Codelistenfehler
Häufige Probleme:
- Ungültige Währung: ISO 4217 Codes verwenden (EUR, USD, GBP)
- Ungültiges Land: ISO 3166-1 Alpha-2 verwenden (DE, FR, IT)
- Ungültige Einheit: UN/ECE Recommendation 20 Codes verwenden
Routing- und Übertragungsfehler
Leitweg-ID nicht gefunden
Fehler: "Die Leitweg-ID konnte nicht zugeordnet werden"
Ursache: Unbekannte oder inaktive Leitweg-ID
Lösung:
- Leitweg-ID mit Empfänger verifizieren
- Auf Tippfehler prüfen (Groß-/Kleinschreibung!)
- Sicherstellen, dass ID noch aktiv ist
Dateigröße überschritten
Fehler: "Maximale Dateigröße überschritten"
Ursache: Rechnungsdatei zu groß (meist >15MB)
Lösung:
- Eingebettete Anhänge entfernen
- Anhänge separat senden
- Dateistruktur optimieren
Fehlerbehebungsschritte
Schritt-für-Schritt Fehlerbehebung
-
Offizielle Validatoren verwenden
- KoSIT-Validator für XRechnung-Konformität
- Portal-spezifische Validatoren
-
Fehlerhierarchie beachten
- Zuerst Schema-Fehler beheben
- Dann Business-Rule-Verletzungen
- Zuletzt Berechnungsfehler
-
Mit Beispielen validieren
- Mit funktionierenden Beispielen vergleichen
- Offizielle Testfälle verwenden
-
Mit Minimalrechnung testen
- Nur mit Pflichtfeldern beginnen
- Optionale Felder schrittweise hinzufügen
Häufige Schnelllösungen
- ✓ Leitweg-ID Zeichen für Zeichen überprüfen
- ✓ Alle Daten im JJJJ-MM-TT Format sicherstellen
- ✓ MwSt-Berechnungen manuell verifizieren
- ✓ Währungs- und Ländercodes prüfen
- ✓ Elektronische Adresse des Verkäufers validieren
- ✓ USt-ID bei steuerpflichtigen Kategorien bestätigen
Validierungsfehler mit unserem Konverter vermeiden
Unser XRechnung-Konverter validiert Ihre Rechnung automatisch und bietet klare Fehlermeldungen mit Lösungen:
- Echtzeit-Validierung bei der Dateneingabe
- Klare Fehlererklärungen in verständlicher Sprache
- Automatische Berechnungsüberprüfung
- Garantierte Formatkonformität
🚀 Bereit, Ihre Rechnungen umzuwandeln?
Beginnen Sie noch heute mit der Umwandlung von PDF-Rechnungen in XRechnung, ZUGFeRD und andere Formate. 3-Tage-Testphase inklusive.