XRechnung Fehlercodes knacken: Ursachen und Lösungen für BR-DE / BR-CO
Stellen Sie sich vor: Sie exportieren am Tag 40 perfekt formatierte E-Rechnungen aus Ihrem ERP-System oder Konverter. Das System meldet Erfolg. Plötzlich schwemmen Ihnen von öffentlichen Auftraggebern (B2G) oder über Peppol von Firmen (B2B) riesige Stornierungs- und Ablehnungsmails herein.
Die Rechnung sei "technisch undankbar" und verletze die Business Rules Germany (BR-DE).
Genau das passiert jeden Tag tausendfach. Das XML-Format der Europäischen Norm EN 16931 ist unerbittlich formell. In diesem tiefen Dive zerlegen wir die schlimmsten KoSIT-Fehlercodes und zeigen Ihnen, welche Dropdown-Felder in Lexware, SAP oder sevDesk Sie dafür reparieren müssen.
Wenn Sie den direkten Weg vom Fehlercode zum passenden Prüfpfad wollen, wechseln Sie auf E-Rechnung validieren.
Was bedeuten die Präfixe (BR-DE, BR-CO)?
Eine E-Rechnung durchläuft oft ein zentrales Prüfportal (z.B. den KoSIT Validator in der ZRE). Die Fehlerklassen sind wie folgt gegliedert:
* BR-CO Codes (Business Rules Core): Europäische Grundregeln. Wenn so ein Fehler aufploppt, z.B. Additionsfehler, ist oft die XML komplett kaputt generiert worden.
* BR-DE Codes (Business Rules Deutschland): Das sind die 21 auf Deutschland fokussierten Spezialbeschränkungen, die über die EU-Norm hinaus vom BMI und BMF draufgesattelt wurden (CIUS). Sie regeln Dinge wie deutsche Steuernummern.
* Error vs. Warning: Ein Error vernichtet die Zulassung der Rechnung – Sie bleibt unbezahlt. Eine Warning wird durchgelassen, ist aber ein Risiko für künftige Skripte.
Bevor Sie weiterlesen: Fehler lokalisieren
Wenn die Kundenmail nur sagt "XRechnung ist fehlerhaft", müssen Sie selbst nachsehen, welcher Code klemmt!
Zum Fehler- und Validierungs-Workflow →Die Big 6 Fehlercodes und ihre Rettungsmaßnahmen
1. BR-DE-1 und BR-DE-15: Das Leitweg-ID Drama
* Der Fehler: Das XML schlägt mit „Das Element 'Buyer reference' (BT-10) muss übermittelt werden“ Alarm.
* Die Ursache: Der XRechnung-Standard verlangt bei Aufträgen an die deutsche Kernverwaltung zwingend einen Identifikator, damit der Hausmeister-Server in Berlin weiß, in welchen Ordner die Rechnung soll. Dieser Identifikator heißt Leitweg-ID.
* Die Lösung: Sie müssen vom Besteller (Schule, Bundeswehr, Ministerium) die genaue ID erfragen und diese im Feld Buyer reference in Ihrer Erstellungssoftware platzieren. B2B-Kunden wollen hier oft einfach nur eine Referenz-Ticketnummer sehen! Purer Freitext "Herr Meier" scheitert hier.
Erweitert:* Mehr Hintergrund zur Leitweg-ID Beschaffung und Modulo-97.
2. BR-CO-17: Die Rechenschieber-Katastrophe
* Der Fehler: Mismatched totals.
Die Ursache: Das ist ein Rundungsfehler. Bsp: ERP rechnet Position 1 = 1.334 € (Netto), 19% USt = 0.25346 € -> Brutto 1.58746 €. Das interne Altsystem kürzt einfach auf 1.58 €. XRechnungen berechnen aber intern hart noch einmal* alle Steuer-Matrizes nach kaufmännischen Rundungen. Haben Sie hier Differenzen ab dem ersten Cent, scheitert der Beleg.
* Die Lösung: Prüfen Sie pro Position Ihre Rabatt-Aufschläge. Excel-Konvertierungen sind hierfür hochgradig anfällig! Das ERP muss streng kaufmännisch auf 2 Dezimalen runden, _bevor_ es in die XML geht.
3. BR-DE-16 / BR-CO-09: "Wer sind Sie steuerlich?"
* Der Fehler: Seller tax registration (BT-32) oder Seller VAT identifier (BT-31) fehlen.
* Die Ursache: Der deutsche Staat zwingt Sie, steuerlich erfasst zu sein. Rechnungen ohne auslesbare Steuernummer werden geschreddert.
* Die Lösung: Haben Sie in den Grund-Einstellungen von sevDesk, lexoffice oder SAP Ihre Firmen-Stammdaten komplettiert? In der XRechnung MUSS mindestens DE12345678 (USt-ID) oder Ihre 13-stellige FA-Steuernummer vorhanden sein.
4. BR-DE-21: Verwechslungsgefahr beim Profil (Syntax)
* Der Fehler: Ungültige Kennung in BT-24 (Specification identifier).
* Die Ursache: Jede XML trägt im Briefkopf eine Notiz darüber, welchem Profil sie folgt. ZUGFeRD Basic hat ein anderes als EN 16931 CIUS. Wenn das Peppol-Netzwerk des Empfängers strikte Compliance für V 3.0.1 verlangt, Sie den Server aber aus Versehen mit dem ZUGFeRD-Minimalprofil (MINIMUM) beschossen haben, kommt der Kickback.
* Die Lösung: Ändern Sie die Export/Generierungs-Einstellungen auf XRechnung bzw. EN 16931. (Oder konvertieren Sie die falschen PDFs um).
5. BR-CL-01 und BR-DE-18: Banken und Krumme Ziffern
* Der Fehler: Währungscode oder Kontoverbindung ISO kaputt.
* Die Ursache: Ein Leerzeichen bei der Dateneingabe der Kunden-IBAN verrutscht, oder statt "EUR" steht im Währungsfeld in der Datenbank "Euro-Geld".
* Die Lösung: XRechnungen verstehen exakt 0 Freitext in Zahlungsknoten. Nutzen Sie EUR, ziehen Sie Leerzeichen aus der IBAN, checken Sie den BIC (Fehler BR-DE-19).
6. BR-DE-5, BR-DE-6, BR-DE-7: Wo wohnt der Verkäufer?
* Die Ursache: Deutsche Sonderregeln für Lieferanten. Wenn Sie in B2B Rechnungen vergessen, im XML-Node die Adresse voll zu füllen oder eine Telefonnummer (BT-42)/Email (BT-43) der Buchhaltung anzugeben (für Rückfragen), weisen pingelige Scanner den Block ab.
Der Workflow: Vom Feuerlöschen zur Prävention
Rechnungsabteilungen sollten sich ab 2026 von der Ansicht verabschieden "Wir probieren's mal". Der Prozess rettet Zeit:
- Fällt ein ERP Update oder eine CSV-Tabelle in die Massenkonvertierung.
- Alle Daten generieren lassen.
- Bevor JEMALS auch nur das SMTP-Netz betreten wird: Stapel-Validierung (Gatekeeping) fahren. Unser Validierungs-Workflow für E-Rechnungen führt Sie in den passenden Prüfpfad.
- Schießt das XML bei Punkt 3 im System eine "BR-DE-XX" Error Flag, dann _blockiert_ das System den Versand.
- Die Buchhaltung geht in die Kundenakte (ERP), repariert exakt diesen Punkt und generiert im nächsten Zyklus fehlerfrei neu.
Tags:
Passende Tools und Branchen
Kontextuelle Empfehlungen auf Basis von Thema, Tags und Inhalt dieses Artikels.
Tool
PDF Konverter
PDF in XRechnung oder ZUGFeRD umwandeln
Tool
XRechnung Validator
XML auf EN 16931 und KoSIT-Regeln prüfen
Tool
ZUGFeRD Validator
ZUGFeRD/Factur-X PDFs automatisch validieren
Tool
XRechnung Generator
XRechnung direkt im Browser erstellen
Branche
Handwerker
E-Rechnungspflicht im Handwerk einfach erfüllen. Keine teure Software nötig. PDF in ZUGFeRD/XRechnung umwandeln.
Branche
IT-Freelancer
E-Rechnung für IT-Freelancer & Programmierer. Kein Abo-Zwang. Einfache Lösung für wenige Rechnungen im Monat.
Branche
Architekten
XRechnung für Architekten & Ingenieure (HOAI). Leitweg-ID Unterstützung für öffentliche Auftraggeber. Einfacher als jede neue Software.



