zugpferd.io › XRechnung Fehlermeldungen

Warum gibt es so viele Fehlermeldungen?

Die XRechnung ist ein streng definierter Standard. Jedes Pflichtfeld muss exakt im richtigen Format vorhanden sein. Fehlt ein einziges Feld oder stimmt ein Wert nicht mit dem Standard überein, lehnt das Empfangssystem die Rechnung ab – oft mit einer kryptischen Fehlermeldung.

Dieses Lexikon erklärt die häufigsten Fehler im Klartext und zeigt, wie du sie behebst.

💡 Tipp: Wenn du eine XRechnung erhalten hast und nur lesen möchtest, brauchst du keine Fehler zu beheben. Ziehe die Datei einfach in den zugpferd.io Viewer – der zeigt dir den Inhalt, auch wenn die Datei technische Mängel hat.

Fehler beim Empfang / Einreichung

!
„Pflichtfeld fehlt" / „Mandatory element missing"
BR-01, BR-02, BR-04 ...

Ein für XRechnung zwingend vorgeschriebenes Feld ist nicht vorhanden. Die häufigsten fehlenden Felder sind: Rechnungsnummer (cbc:ID), Rechnungsdatum (cbc:IssueDate), Fälligkeitsdatum oder Lieferdatum.

✅ Lösung: Prüfe in deiner Buchhaltungssoftware, ob alle Pflichtfelder ausgefüllt sind. Bei selbst erstellten Rechnungen hilft der Validool-Validator, der genau zeigt, welches Feld fehlt.
!
„Ungültiges Datum" / „Invalid date format"
BR-03, PEPPOL-EN16931-R001

Das Datum ist im falschen Format angegeben. XRechnung erwartet Datumsangaben im Format YYYY-MM-DD (z. B. 2025-03-15). Deutsche Schreibweisen wie 15.03.2025 oder 15/03/2025 sind nicht zulässig.

✅ Lösung: Stelle in deiner Software das Exportformat auf ISO 8601 (YYYY-MM-DD) um. Bei manuell erstellten Dateien alle Datumsfelder entsprechend anpassen.
!
„Steuernummer fehlt oder ungültig"
BR-CO-09, BR-CO-10

Eine der beiden Steueridentifikationen (Steuernummer oder Umsatzsteuer-ID) des Rechnungsstellers fehlt oder hat ein ungültiges Format. Die USt-ID muss zwingend mit dem Länderkürzel beginnen (z. B. DE307591242).

✅ Lösung: Trage in deiner Software beide Steuer-IDs vollständig ein. Die USt-ID muss mit Länderpräfix, ohne Leerzeichen und ohne Punkte angegeben werden.
⚠
„Betrag stimmt nicht überein" / „Amount mismatch"
BR-CO-13, BR-CO-15, BR-CO-16

Der Gesamtbetrag stimmt rechnerisch nicht mit der Summe der Positionen überein. XRechnung prüft alle Beträge mathematisch: Netto + MwSt muss exakt dem Brutto entsprechen, Rundungsfehler eingeschlossen.

✅ Lösung: Prüfe alle Beträge auf Rundungsdifferenzen. XRechnung erlaubt ein Rundungsfeld (cbc:PayableRoundingAmount) für kleine Differenzen. Lass die Beträge von deiner Software automatisch berechnen statt manuell einzutragen.
⚠
„Ungültige Währung" / „Invalid currency code"
BR-05, BR-CL-04

Der Währungscode ist nicht im ISO 4217-Format angegeben. Statt Euro oder € muss der dreistellige ISO-Code EUR verwendet werden.

✅ Lösung: Ersetze alle Währungsangaben durch den korrekten ISO 4217-Code: EUR, USD, GBP etc.

Fehler beim Öffnen / Lesen

i
„Datei kann nicht geöffnet werden" (Windows/Mac)

Windows oder macOS kennt keine Standardanwendung für .xml-Dateien im Rechnungsformat. Ein Doppelklick öffnet die Datei im Texteditor – das Ergebnis ist unlesbarer Code.

✅ Lösung: Öffne zugpferd.io im Browser und ziehe die Datei dort hinein. Keine Installation nötig.
i
„XML-Parsing-Fehler" / „not well-formed"

Die XML-Datei ist technisch beschädigt – z. B. durch fehlerhafte Sonderzeichen, nicht geschlossene Tags oder falsche Zeichenkodierung. Das passiert manchmal beim manuellen Bearbeiten von XML-Dateien.

✅ Lösung: Fordere die Datei erneut an oder lass sie vom Absender neu generieren. Falls du die Datei selbst erstellt hast, prüfe sie mit einem XML-Validator wie xmlvalidation.com.
i
„Format nicht erkannt"

Die XML-Datei entspricht keinem bekannten E-Rechnungsformat. Möglicherweise handelt es sich um eine ältere EDIFACT-Rechnung, ein proprietäres Format oder eine beschädigte Datei.

✅ Lösung: Prüfe beim Absender, in welchem Format die Rechnung ausgestellt wurde. zugpferd.io unterstützt XRechnung UBL, XRechnung CII, ZUGFeRD 1.x und 2.x sowie Peppol BIS 3.0.

Rechnung trotz Fehler lesen?

zugpferd.io zeigt dir den Inhalt auch bei kleineren technischen Mängeln – einfach ausprobieren.

Zum Viewer →

XRechnung vor dem Versand prüfen

Um Fehler beim Empfänger zu vermeiden, solltest du jede XRechnung vor dem Versand validieren. Die offizielle Möglichkeit ist der KoSIT Validator der Koordinierungsstelle für IT-Standards – kostenlos und ohne Registrierung. Er prüft deine XML-Datei gegen alle offiziellen Regeln und zeigt dir genau, welche Felder fehlen oder falsch sind.

Alternativ bieten viele Buchhaltungsprogramme (Lexoffice, sevDesk, DATEV) eine integrierte Validierung vor dem Export an.