Ratgeber · Stand 2026-10

XRechnung-Fehlercodes erklärt: BR-DE-1 bis BR-DE-31, BR-CO, PEPPOL — und wie Sie sie beheben

xrechnung.dev

Der Validator sagt Ihnen was falsch ist, in der Sprache der Norm. Diese Seite übersetzt die häufigsten Codes in Klartext; jeder Code hat eine eigene Seite mit Ursache, Behebung und XML-Beispiel. „BT-…“ ist die Feldnummer der EN 16931 (Business Term), „BR-DE-…“ sind die deutschen Zusatzregeln der XRechnung.

Fehler machen die Rechnung ungültig. Warnungen nicht, manche Empfänger lehnen trotzdem ab.

Deutsche Zusatzregeln (BR-DE)

CodeBedeutungArt
BR-DE-1Zahlungsangaben (BG-16) fehlenFehler
BR-DE-2Kontaktdaten des Verkäufers (BG-6) fehlenFehler
BR-DE-3Ort des Verkäufers (BT-37) fehltFehler
BR-DE-4Postleitzahl des Verkäufers (BT-38) fehltFehler
BR-DE-5Ansprechpartner des Verkäufers (BT-41) fehltFehler
BR-DE-6Telefonnummer des Verkäufers (BT-42) fehltFehler
BR-DE-7E-Mail-Adresse des Verkäufers (BT-43) fehltFehler
BR-DE-8Ort des Käufers (BT-52) fehltFehler
BR-DE-9Postleitzahl des Käufers (BT-53) fehltFehler
BR-DE-10Ort der Lieferanschrift (BT-77) fehltFehler
BR-DE-11Postleitzahl der Lieferanschrift (BT-78) fehltFehler
BR-DE-14Steuersatz (BT-119) in der Steueraufschlüsselung fehltFehler
BR-DE-15Käuferreferenz (BT-10) fehltFehler
BR-DE-16USt-IdNr. oder Steuernummer des Verkäufers fehltFehler
BR-DE-17Unzulässiger Rechnungstyp (BT-3)Warnung
BR-DE-18Skonto-Angabe falsch formatiertFehler
BR-DE-19IBAN für Überweisung ungültigWarnung
BR-DE-21Spezifikationskennung (BT-24) passt nicht zu XRechnungWarnung
BR-DE-22Doppelte Dateinamen bei AnhängenFehler
BR-DE-23Überweisung ohne KontoangabenFehler
BR-DE-24Kartenzahlung ohne KartenangabenFehler
BR-DE-25Lastschrift ohne LastschriftangabenFehler
BR-DE-26Rechnungskorrektur ohne Bezug auf die OriginalrechnungWarnung
BR-DE-27Telefonnummer des Verkäufers zu kurzWarnung
BR-DE-28E-Mail-Adresse des Verkäufers formal falschWarnung
BR-DE-30Lastschrift ohne Gläubiger-ID (BT-90)Fehler
BR-DE-31Lastschrift ohne Konto des Kunden (BT-91)Fehler
BR-DE-20IBAN für Lastschrift ungültigWarnung

Übergangsregeln (BR-TMP)

CodeBedeutungArt
BR-DE-TMP-32Kein Liefer- oder LeistungsdatumHinweis
BR-TMP-2Externer Anhang ohne gültige URL (BT-124)Fehler
BR-TMP-3Preisbasismenge bei Brutto- und Nettopreis verschiedenFehler
BR-TMP-4Anhang mit mehreren BeschreibungenWarnung
BR-TMP-5Mehrere Dateien in einem Anhang-BlockWarnung
BR-TMP-6Datum in UBL nicht im Format JJJJ-MM-TTWarnung
BR-TMP-7Datum in CII nicht im Format 102 (JJJJMMTT)Warnung

Fahrzeugbeschaffung (BR-DE-CVD)

Nur für Rechnungen über Fahrzeuge an öffentliche Auftraggeber nach dem Saubere-Fahrzeuge-Beschaffungs-Gesetz.

CodeBedeutungArt
BR-DE-CVD-01Fahrzeugrechnung ohne Vertragsnummer (BT-12)Fehler
BR-DE-CVD-02Fahrzeugrechnung ohne Vergabe- oder Losnummer (BT-17)Fehler
BR-DE-CVD-03Keine Rechnungszeile mit FahrzeugangabenFehler
BR-DE-CVD-04Unzulässige FahrzeugklasseFehler
BR-DE-CVD-05Unzulässiger Wert für das Merkmal „cva“Fehler
BR-DE-CVD-06Fahrzeugklasse und „cva“ nicht in derselben ZeileFehler
BR-TMP-CVD-01Unbekanntes Schema für die ArtikelklassifikationFehler

XRechnung Extension (BR-DEX)

Nur für Rechnungen im Extension-Format (Unterpositionen, Zahlungen Dritter).

CodeBedeutungArt
BR-DEX-01Unzulässiger Dateityp im Anhang (Extension)Fehler
BR-DEX-02Summe der Unterpositionen stimmt nichtWarnung
BR-DEX-03Unterposition ohne SteuerangabeFehler
BR-DEX-04Ungültiges Schema bei der Partei-Kennung (Extension)Fehler
BR-DEX-05Ungültiges Schema bei der Registernummer (Extension)Fehler
BR-DEX-06Ungültiges Schema bei der Artikelkennung (Extension)Fehler
BR-DEX-07Ungültiges Schema bei der elektronischen Adresse (Extension)Fehler
BR-DEX-08Ungültiges Schema bei der Lieferort-Kennung (Extension)Fehler
BR-DEX-09Zahlbetrag stimmt nicht (mit Zahlungen Dritter)Fehler
BR-DEX-10Zahlung Dritter: BT-DEX-001 fehltFehler
BR-DEX-11Zahlung Dritter: BT-DEX-002 fehltFehler
BR-DEX-12Zahlung Dritter: BT-DEX-003 fehltFehler
BR-DEX-13Zahlung Dritter: zu viele NachkommastellenFehler
BR-DEX-14Zahlung Dritter: falsche WährungFehler
BR-DEX-15CII-Datei mit UnterpositionenWarnung

Rechenregeln (BR-CO)

CodeBedeutungArt
BR-CO-09USt-IdNr. ohne LänderkennungFehler
BR-CO-10Summe der Positionen stimmt nichtFehler
BR-CO-13Nettosumme stimmt nichtFehler
BR-CO-14Steuersumme stimmt nichtFehler
BR-CO-15Bruttosumme ≠ Netto + SteuerFehler
BR-CO-16Zahlbetrag stimmt nichtFehler
BR-CO-17Steuerbetrag pro Steuersatz falsch berechnetFehler
BR-CO-18Keine SteueraufschlüsselungFehler
BR-CO-26Verkäufer nicht identifizierbarFehler

Umsatzsteuer und Pflichtangaben

CodeBedeutungArt
BR-S-08Bemessungsgrundlage für 19 % / 7 % stimmt nichtFehler
BR-S-09Steuerbetrag für 19 % / 7 % falsch berechnetFehler
BR-AE-10Reverse Charge ohne HinweisFehler
BR-E-10Steuerbefreiung ohne BegründungFehler
BR-16Keine RechnungspositionFehler

Peppol-Regeln in XRechnung 3.0

CodeBedeutungArt
PEPPOL-EN16931-R001Geschäftsprozess-Kennung (BT-23) fehltFehler
PEPPOL-EN16931-R008Leere Elemente in der DateiFehler

Strukturfehler (XSD)

„cvc-complex-type…“ oder „Element … not expected“: die XML entspricht nicht dem Schema (UBL 2.1 bzw. UN/CEFACT CII D16B). Ursache ist fast immer eine falsche Reihenfolge der Elemente oder ein Element am falschen Ort. Hier hilft nur, die Datei mit einer Bibliothek zu erzeugen statt von Hand.

Sie haben eine fehlerhafte Rechnung nur empfangen? Den Text für die Korrekturanforderung an den Absender erstellen Sie hier: Korrektur anfordern.

Alle Codes im Kontext sehen: Datei prüfen. Der Bericht nennt Code, Meldung und die XPath-Stelle im Dokument und verlinkt auf die passende Erklärung.

Testdateien für jeden Fehlercode: 137 fehlerhafte XRechnungen (UBL und CII, MIT-Lizenz), je eine pro Regel, gegen den KoSIT-Validator geprüft.

Codes und Originaltexte: offizielle Prüfkonfiguration der KoSIT für XRechnung 3.0.2.

Jetzt prüfen – kostenlos, ohne Anmeldung

Ziehen Sie Ihre XRechnung oder ZUGFeRD-Datei auf xrechnung.dev. Sie sehen in Sekunden, ob sie gültig ist und welche Regel verletzt wurde, geprüft mit dem KoSIT-Prüfwerkzeug. Entwickler: dieselbe Prüfung und das Erzeugen geprüfter Rechnungen als API.

xrechnung.dev prüft XRechnung und ZUGFeRD mit dem offiziellen Prüfwerkzeug der KoSIT (Validator 1.6.3, Konfiguration XRechnung 3.0.2 vom 31.08.2026, Schematron 2.6.0, EN-16931-Regeln 1.3.16); xrechnung.dev ist ein unabhängiger Dienst. 30 Dokumente pro Monat kostenlos, ohne Anmeldung. Dateien werden nicht gespeichert. Server in Frankfurt am Main.