Fehlercodes der E-Rechnung

Lexikon

Wenn eine XRechnung abgelehnt wird, nennt der Validator einen Regelcode wie BR-DE-15 oder BR-CO-14. Diese Übersicht erklärt, was der Code bedeutet, welches Feld betroffen ist und wie Sie ihn beheben — mit kopierbarem XML-Beispiel.

16 häufige Codes erklärtUrsache & konkreter FixDirekt verlinkbar

16 von 16 Fehlercodes. Jede Karte ist direkt verlinkbar, z. B. /fehlercodes#BR-DE-15.

  • BR-DE-1Fatal — blockiert die AnnahmeXRechnung (BR-DE)

    Zahlungsanweisungen (Payment Instructions) fehlen

    Betroffene Felder:BG-16BT-81

    Ursache

    Jede deutsche XRechnung muss mindestens eine Zahlungsart (z. B. Code 58 für SEPA-Überweisung) in BG-16 angeben.

    Konkrete Lösung

    Ergänzen Sie cac:PaymentMeans mit PaymentMeansCode 58 und hinterlegen Sie bei Überweisung die IBAN des Zahlungsempfängers.

    Eigene Rechnung auf diesen Code prüfen
    XML-Beispiel
    <cac:PaymentMeans>
      <cbc:PaymentMeansCode>58</cbc:PaymentMeansCode>
      <cac:PayeeFinancialAccount>
        <cbc:ID>DE89370400440532013000</cbc:ID>
      </cac:PayeeFinancialAccount>
    </cac:PaymentMeans>
  • BR-DE-2Fatal — blockiert die AnnahmeXRechnung (BR-DE)

    Ansprechpartner des Verkäufers fehlt oder unvollständig

    Betroffene Felder:BG-6BT-41BT-42BT-43

    Ursache

    XRechnung verlangt zwingend einen Kontakt beim Verkäufer inklusive Name (BT-41), Telefonnummer (BT-42) und E-Mail-Adresse (BT-43).

    Konkrete Lösung

    Füllen Sie in AccountingSupplierParty → Party → Contact alle drei Felder vollständig aus.

    Eigene Rechnung auf diesen Code prüfen
    XML-Beispiel
    <cac:Contact>
      <cbc:Name>Anna Weber</cbc:Name>
      <cbc:Telephone>+49 30 901820</cbc:Telephone>
      <cbc:ElectronicMail>rechnung@firma.de</cbc:ElectronicMail>
    </cac:Contact>
  • BR-DE-5Fatal — blockiert die AnnahmeXRechnung (BR-DE)

    Kontaktname beim Verkäufer (BT-41) fehlt

    Betroffene Felder:BT-41

    Ursache

    Die Gruppe BG-6 (Seller Contact) ist zwar vorhanden, enthält aber keinen Ansprechpartner-Namen.

    Konkrete Lösung

    Setzen Sie cbc:Name im Contact-Block des Verkäufers (z. B. Sachbearbeitung oder Vor- und Nachname).

    Eigene Rechnung auf diesen Code prüfen
    XML-Beispiel
    <cac:Contact>
      <cbc:Name>Buchhaltung</cbc:Name>
      <cbc:Telephone>+49 30 123456</cbc:Telephone>
      <cbc:ElectronicMail>fibu@firma.de</cbc:ElectronicMail>
    </cac:Contact>
  • BR-DE-6Fatal — blockiert die AnnahmeXRechnung (BR-DE)

    Telefonnummer des Verkäufer-Kontakts (BT-42) fehlt

    Betroffene Felder:BT-42

    Ursache

    Im deutschen CIUS XRechnung darf die Telefonnummer für Rückfragen nicht leer bleiben.

    Konkrete Lösung

    Tragen Sie eine gültige Telefonnummer im Element cbc:Telephone (UBL) bzw. ram:TelephoneUniversalCommunication (CII) ein.

    Eigene Rechnung auf diesen Code prüfen
    XML-Beispiel
    <cbc:Telephone>+49 30 901820</cbc:Telephone>
  • BR-DE-7Fatal — blockiert die AnnahmeXRechnung (BR-DE)

    E-Mail-Adresse des Verkäufer-Kontakts (BT-43) fehlt

    Betroffene Felder:BT-43

    Ursache

    XRechnung fordert eine E-Mail-Adresse für automatisierte Rückmeldungen oder Rückfragen zum Beleg.

    Konkrete Lösung

    Hinterlegen Sie cbc:ElectronicMail beim Verkäuferkontakt.

    Eigene Rechnung auf diesen Code prüfen
    XML-Beispiel
    <cbc:ElectronicMail>rechnung@muster-gmbh.de</cbc:ElectronicMail>
  • BR-DE-15Fatal — blockiert die AnnahmeXRechnung (BR-DE)

    Käufer-Referenz / Leitweg-ID (BT-10) fehlt

    Betroffene Felder:BT-10

    Ursache

    Im Profil XRechnung ist BT-10 (BuyerReference) ein Pflichtfeld — bei öffentlichen Auftraggebern ist dies die Leitweg-ID, im B2B-Umfeld oft eine Bestell- oder Kostenstellenreferenz.

    Konkrete Lösung

    Tragen Sie in cbc:BuyerReference die vom Empfänger mitgeteilte Leitweg-ID oder eine eindeutige Referenz ein.

    Eigene Rechnung auf diesen Code prüfen
    XML-Beispiel
    <cbc:BuyerReference>991-0000019-94</cbc:BuyerReference>
  • BR-DE-16Fatal — blockiert die AnnahmeXRechnung (BR-DE)

    Steuernummer oder USt-IdNr. des Verkäufers fehlt

    Betroffene Felder:BT-31BT-32

    Ursache

    Deutsche Rechnungen verlangen mindestens eine steuerliche Kennung (USt-IdNr. BT-31 oder Steuernummer BT-32).

    Konkrete Lösung

    Geben Sie in cac:PartyTaxScheme entweder die USt-IdNr. (Scheme VAT) oder die Steuernummer (Scheme FC) an.

    Eigene Rechnung auf diesen Code prüfen
    XML-Beispiel
    <cac:PartyTaxScheme>
      <cbc:CompanyID>DE123456789</cbc:CompanyID>
      <cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
    </cac:PartyTaxScheme>
  • BR-DE-17Fatal — blockiert die AnnahmeXRechnung (BR-DE)

    Nicht zulässiger Rechnungsart-Code (BT-3)

    Betroffene Felder:BT-3

    Ursache

    XRechnung erlaubt nur die UNTDID-1001-Codes 326, 380, 381, 384, 389, 875, 876 oder 877.

    Konkrete Lösung

    Verwenden Sie für Standardrechnungen Code 380 und für Gutschriften/Stornorechnungen Code 381.

    Eigene Rechnung auf diesen Code prüfen
    XML-Beispiel
    <cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
  • BR-DE-21Fatal — blockiert die AnnahmeXRechnung (BR-DE)

    CustomizationID entspricht nicht XRechnung 3.0

    Betroffene Felder:BT-24

    Ursache

    Der Profil-Bezeichner (BT-24) weicht von der offiziellen Spezifikation ab (z. B. veraltete XRechnung 1.2/2.0 Kennung).

    Konkrete Lösung

    Nutzen Sie für XRechnung 3.0.x die aktuelle urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0.

    Eigene Rechnung auf diesen Code prüfen
    XML-Beispiel
    <cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0</cbc:CustomizationID>
  • BR-CO-10Fatal — blockiert die AnnahmeBerechnung (BR-CO)

    Summe der Positionsnettobeträge (BT-106) stimmt nicht

    Betroffene Felder:BT-106BT-131

    Ursache

    LineExtensionAmount weicht von der exakten Summe aller BT-131-Positionsbeträge ab (häufig durch Rundungsfehler).

    Konkrete Lösung

    Berechnen Sie jede Position auf 2 Nachkommastellen kaufmännisch gerundet und summieren Sie anschließend exakt.

    Eigene Rechnung auf diesen Code prüfen
    XML-Beispiel
    <cbc:LineExtensionAmount currencyID="EUR">3530.00</cbc:LineExtensionAmount>
  • BR-CO-14Fatal — blockiert die AnnahmeBerechnung (BR-CO)

    Gesamtsteuerbetrag (BT-110) stimmt nicht mit MwSt.-Aufschlüsselung überein

    Betroffene Felder:BT-110BT-117

    Ursache

    TaxAmount im Dokumentkopf entspricht nicht der Summe der einzelnen TaxSubtotal-Beträge (BT-117).

    Konkrete Lösung

    Summieren Sie die Steuerbeträge je Steuersatz-Gruppe (BG-23) und übernehmen Sie diesen Wert als TaxTotal/TaxAmount.

    Eigene Rechnung auf diesen Code prüfen
    XML-Beispiel
    <cac:TaxTotal>
      <cbc:TaxAmount currencyID="EUR">670.70</cbc:TaxAmount>
    </cac:TaxTotal>
  • BR-CO-15Fatal — blockiert die AnnahmeBerechnung (BR-CO)

    Bruttobetrag (BT-112) ungleich Netto + Steuer

    Betroffene Felder:BT-112BT-109BT-110

    Ursache

    TaxInclusiveAmount entspricht nicht der Summe aus TaxExclusiveAmount und TaxAmount.

    Konkrete Lösung

    Prüfen Sie BT-112 = BT-109 + BT-110 auf Cent-genaue Übereinstimmung.

    Eigene Rechnung auf diesen Code prüfen
    XML-Beispiel
    <cbc:TaxInclusiveAmount currencyID="EUR">4200.70</cbc:TaxInclusiveAmount>
  • BR-CO-25Fatal — blockiert die AnnahmeEN 16931 (BR)

    Fälligkeitsdatum (BT-9) oder Zahlungsbedingungen (BT-20) fehlen bei positivem Zahlbetrag

    Betroffene Felder:BT-9BT-20

    Ursache

    Wenn der zu zahlende Betrag (BT-115) > 0 ist, muss mindestens ein Fälligkeitsdatum oder ein Zahlungsbedingungs-Text angegeben sein.

    Konkrete Lösung

    Geben Sie entweder cbc:DueDate (YYYY-MM-DD) oder cac:PaymentTerms/cbc:Note an.

    Eigene Rechnung auf diesen Code prüfen
    XML-Beispiel
    <cbc:DueDate>2026-12-06</cbc:DueDate>
  • BR-S-08Fatal — blockiert die AnnahmeUSt (BR-S/E)

    Steuerbemessungsgrundlage für Steuersatz S stimmt nicht

    Betroffene Felder:BT-116BT-118

    Ursache

    Die Summe der Netto-Positionen (plus/minus Dokumentzuschläge) für einen S-Steuersatz passt nicht zu TaxableAmount in BG-23.

    Konkrete Lösung

    Gruppieren Sie alle Positionen nach Steuersatz (z. B. 19% und 7%) und bilden Sie pro Satz ein eigenes TaxSubtotal.

    Eigene Rechnung auf diesen Code prüfen
    XML-Beispiel
    <cac:TaxSubtotal>
      <cbc:TaxableAmount currencyID="EUR">1000.00</cbc:TaxableAmount>
      <cbc:TaxAmount currencyID="EUR">190.00</cbc:TaxAmount>
      <cac:TaxCategory>
        <cbc:ID>S</cbc:ID>
        <cbc:Percent>19</cbc:Percent>
        <cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
      </cac:TaxCategory>
    </cac:TaxSubtotal>
  • BR-E-10Fatal — blockiert die AnnahmeUSt (BR-S/E)

    Steuerbefreiungsgrund (BT-120) fehlt bei Kategorie E

    Betroffene Felder:BT-120BT-121

    Ursache

    Bei steuerbefreiten Umsätzen (z. B. Kleinunternehmer §19 UStG, Kategorie E) muss ein Befreiungstext angegeben werden.

    Konkrete Lösung

    Ergänzen Sie cbc:TaxExemptionReason im TaxCategory-Block (z. B. "Kleinunternehmer gemäß § 19 UStG").

    Eigene Rechnung auf diesen Code prüfen
    XML-Beispiel
    <cac:TaxCategory>
      <cbc:ID>E</cbc:ID>
      <cbc:Percent>0</cbc:Percent>
      <cbc:TaxExemptionReason>Kein Ausweis von Umsatzsteuer gemäß § 19 UStG.</cbc:TaxExemptionReason>
      <cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
    </cac:TaxCategory>
  • PEPPOL-EN16931-R008Fatal — blockiert die AnnahmePeppol

    Leeres XML-Element gefunden

    Betroffene Felder:BT-34BT-49

    Ursache

    Peppol und XRechnung verbieten leere XML-Tags (z. B. <cbc:Note></cbc:Note> oder <cbc:StreetName/>).

    Konkrete Lösung

    Entfernen Sie alle leeren XML-Tags vollständig, statt sie ohne Inhalt zu exportieren.

    Eigene Rechnung auf diesen Code prüfen
    XML-Beispiel
    <!-- Falsch: <cbc:Note/> -->
    <!-- Richtig: Tag weglassen, wenn kein Hinweis vorhanden ist. -->

Diese Übersicht erklärt die häufigsten Fehlercodes aus XRechnung, EN 16931, den Rechenregeln (BR-CO) und Peppol. Eine vollständige Prüfung mit Zeilennummer und kontextbezogenem Fix liefert der XRechnung-Validator.

So funktioniert es

01

Code nachschlagen

Suchen Sie nach dem Regelcode aus der Fehlermeldung, nach einem Feld wie BT-10 oder nach einem Stichwort wie „Rundung“.

02

Ursache verstehen

Jede Karte nennt das betroffene Feld, warum die Regel greift und was der Empfänger bzw. das Portal daran bemängelt.

03

Fix anwenden

Übernehmen Sie die konkrete Lösung und vergleichen Sie mit dem XML-Beispiel — oder prüfen Sie die korrigierte Datei direkt im Validator.

Häufige Fragen

Was bedeuten die Kürzel BR, BR-DE und BR-CO?

BR steht für Business Rule. Regeln ohne Länderkürzel (BR-01 bis BR-65) gelten für ganz EN 16931. BR-DE-Regeln sind deutsche XRechnung-Vorgaben, BR-CO-Regeln prüfen die rechnerische Konsistenz (CO = calculation), BR-S und BR-E betreffen Umsatzsteuer bzw. Ermäßigungen, und PEPPOL-EN16931-Regeln gelten zusätzlich im Peppol-Netzwerk.

Was ist der Unterschied zwischen fatal und Warnung?

Ein fataler Fehler verletzt eine verbindliche Regel — die Rechnung gilt als nicht konform und kann von Empfängern oder Portalen abgelehnt werden. Warnungen weisen auf ungewöhnliche oder unvollständige Angaben hin, die technisch zulässig sind, aber Rückfragen auslösen können.

Warum scheitert BR-DE-15 so oft?

BR-DE-15 verlangt die Leitweg-ID des Rechnungsempfängers in BT-10 (BuyerReference). Bei öffentlichen Auftraggebern ist sie Pflicht; sie wird häufig vergessen, falsch formatiert oder in ein anderes Feld (z. B. OrderReference) geschrieben. Der Leitweg-ID-Prüfer zeigt, ob Aufbau und Prüfziffer stimmen.

Sind die XML-Beispiele vollständige Rechnungen?

Nein, die Beispiele zeigen nur den relevanten Ausschnitt. Sie sind zum Vergleichen und Einfügen in Ihre eigene Rechnung gedacht — die umgebende Struktur (UBL oder CII) muss bereits vorhanden sein.

Wie finde ich den Fehler in meiner eigenen Datei?

Laden Sie die XML- oder ZUGFeRD-Datei in den XRechnung-Validator. Er prüft alle Regeln, zeigt die betroffene Zeile und erklärt jeden Fund in Klartext — inklusive direktem Verweis auf diese Übersicht.

Weitere kostenlose Werkzeuge

Alle 8 Werkzeuge ansehen →