Die E-Rechnung ist fertig. Doch bei der Prüfung erscheint eine Meldung wie cvc-complex-type.2.4.a, BR-S-08 oder PEPPOL-EN16931-R008. Was bedeutet das? Wo liegt die Ursache? Und wer kann den Fehler beheben?
Mit ValiBot haben wir begonnen, solche Meldungen verständlich zu erklären. Jetzt gehen wir einen Schritt weiter: Wir haben die 50 häufigsten E-Rechnungsfehler aus unseren Prüfungen ausführlich aufbereitet. Mit verständlichen Erklärungen für den Arbeitsalltag und technischen Details für alle, die Rechnungssoftware entwickeln oder Schnittstellen betreuen.
Die neue Fehlerübersicht für E-Rechnungen verbindet Häufigkeiten aus der Praxis mit Ursachen, XML-Beispielen und Lösungswegen.
Welche Fehler treten bei E-Rechnungen tatsächlich häufig auf?
Unsere Sammlung orientiert sich an den Fehlermeldungen aus den Prüfungen auf erechnungs-validator.de. Die Übersicht zeigt zu jedem Fehlercode eine kurze Bedeutung, die Zahl der betroffenen Prüfungen und den zugehörigen Anteil.
Die fünf häufigsten Fehler in unserer Auswertung, mit ihrem Anteil an allen ungültigen Prüfungen:
- cvc-complex-type.2.4.a (15,6 %): Ein XML-Element steht an einer unerwarteten Stelle, etwa durch eine falsche Reihenfolge.
- PEPPOL-EN16931-R008 (7,4 %): Die Datei enthält leere Elemente, die nicht erlaubt sind. Die Regel stammt aus dem Peppol-Regelwerk; der KoSIT-Validator wendet sie auch bei XRechnungen an.
- BR-S-08 (6,5 %): Die Steuerbasis beim Normalsteuersatz stimmt nicht.
- BR-CO-10 (5,1 %): Die Summe der Positionsnettobeträge stimmt nicht.
- BR-CO-09 (4,8 %): Der Umsatzsteuer-Identifikationsnummer fehlt ein gültiges Länderkürzel (für Griechenland gilt EL, nicht GR).
Hinweis zur Auswertung: Gezählt sind ungültige Prüfungen vom 8. Januar bis 17. November 2026, nicht verschiedene Rechnungen; dieselbe Datei kann mehrfach geprüft worden sein. Bis zum 14. November 2026 prüfte der Validator noch mit älteren Regeln und wandelte UBL-Rechnungen vor der Prüfung um (siehe Validator-Update). Mit den aktuellen Regeln können sich Rangfolge und Anteile verschieben.
Damit wird sichtbar, welche Probleme in unseren Prüfungen besonders oft vorkommen. Das hilft Anwendern bei der Einordnung und gibt Softwareentwicklern Anhaltspunkte dafür, welche Fehlerbilder besondere Aufmerksamkeit verdienen.
Fehlercode suchen – oder den ganzen Prüfbericht einfügen
Nicht jeder kennt den genauen Fehlercode. Deshalb lässt sich die neue Übersicht auf unterschiedlichen Wegen nutzen.
Sie können nach einem Code wie BR-DE-15 suchen, eine Feldnummer wie BT-10 eingeben oder einen Begriff wie Leitweg verwenden. Auch ein ganzer Prüfbericht lässt sich in das Suchfeld einfügen.
Das erleichtert den Einstieg gerade dann, wenn ein Prüfbericht mehrere technische Meldungen enthält. Statt einzelne Codes mühsam zu übertragen, können Sie den vorhandenen Bericht als Ausgangspunkt nehmen.
Hier Fehlercode suchen oder Prüfbericht einfügen
Verständlich für Anwender, detailliert für Entwickler
Wer Rechnungen erstellt, braucht andere Informationen als jemand, der den XML-Export programmiert. Unsere Erklärungen berücksichtigen beide Perspektiven.
Für Anwender stehen zunächst einfache Fragen im Mittelpunkt: Was ist falsch? Kann ich die Ursache in meiner Rechnungssoftware beheben? Muss ich den Softwareanbieter kontaktieren? Oder sollte ich als Empfänger eine korrigierte Rechnung anfordern?
Für Entwickler geht die Erklärung tiefer: Was verlangt die Regel genau? Welche Struktur wird erwartet? Wie unterscheiden sich ein fehlerhafter und ein korrigierter XML-Ausschnitt?
Wie das zusammenkommt, zeigt unser ausführlicher Beitrag zu cvc-complex-type.2.4.a. Er führt von einer verständlichen Einordnung über typische Ursachen zu technischen Beispielen und konkreten Handlungsschritten.
Beispiel: Was bedeutet cvc-complex-type.2.4.a?
Dieser Fehler steht in unserer Auswertung auf Platz eins: 5.745 von 36.827 ungültigen Prüfungen enthielten diese Meldung. Das entspricht 15,6 Prozent im Zeitraum vom 8. Januar bis 17. November 2026.
Die verständliche Erklärung lautet: In der XML-Datei steht ein Element an einer Stelle, an der es laut vorgegebenem Aufbau nicht erwartet wird. Beispielsweise ist die Reihenfolge vertauscht, ein erforderliches Element davor fehlt oder der Namensraum stimmt nicht.
Für Anwender ist dabei eine Information besonders hilfreich: Die Ursache liegt häufig in dem Programm, das die Rechnungsdatei erzeugt. Dann ist der Prüfbericht eine wichtige Grundlage für die Rückfrage beim Softwareanbieter.
Entwickler finden im Beitrag konkrete Gegenüberstellungen für CII und UBL. Die XML-Beispiele zeigen, wie eine fehlerhafte Reihenfolge aussieht und wie sie korrigiert wird. Die Änderungen sind hervorgehoben, damit der entscheidende Unterschied schnell erkennbar ist.
cvc-complex-type.2.4.a: Erklärung, Beispiele und Lösung ansehen
Konkrete nächste Schritte für drei unterschiedliche Rollen
Eine hilfreiche Fehlererklärung berücksichtigt auch, wer gerade vor dem Prüfbericht sitzt. Der Beitrag zu cvc-complex-type.2.4.a unterscheidet deshalb drei Situationen:
Ich erstelle Rechnungen
Hier geht es darum, die Ursache einzuordnen und bei einem Problem im Dateiaufbau den Softwarehersteller mit den nötigen Informationen zu versorgen.
Ich entwickle Software
Hier stehen die erwarteten Elemente, ihre Reihenfolge und die Prüfung der erzeugten XML-Datei im Mittelpunkt.
Ich habe eine Rechnung erhalten
Hier hilft die Erklärung dabei, eine korrigierte Datei anzufordern und den Prüfbericht als nachvollziehbare Begründung mitzugeben.
So wird aus derselben technischen Meldung für jede Rolle ein passender nächster Schritt.
Fehler hängen zusammen – die Reihenfolge der Behebung zählt
Ein Prüfbericht mit mehreren Meldungen bedeutet nicht zwangsläufig, dass genauso viele voneinander unabhängige Ursachen vorliegen. Ein Strukturproblem kann weitere Meldungen auslösen oder nachfolgende Prüfungen verhindern.
Der Beitrag zu cvc-complex-type.2.4.a erklärt deshalb auch die Folgen und Zusammenhänge mit anderen Fehlercodes. Die praktische Empfehlung lautet: Zuerst den Schemafehler beheben und anschließend erneut prüfen.
Die erneute Prüfung zeigt dann, ob weitere Probleme bestehen. Deshalb endet die Fehlererklärung auch mit dem direkten Weg zurück zum Validator.
Nachvollziehbare Beispiele und Quellen
Technische Hilfestellung wird nützlicher, wenn ihre Grundlage erkennbar ist. Der Detailartikel nennt deshalb Quellen und Prüfstand und erläutert, woher die Häufigkeitsangaben stammen.
Auch die XML-Beispiele haben wir maschinell getestet: Das fehlerhafte Beispiel löst die beschriebene Meldung aus, die Korrektur behebt sie. Der Prüfstand ist im Beitrag dokumentiert.
Für Entwickler entsteht damit eine konkrete Grundlage, um das Fehlerbild nachzuvollziehen und mit dem eigenen Export zu vergleichen.
Die logische Weiterentwicklung der ValiBot-Idee
Hinter ValiBot steht eine einfache Idee: Wer eine E-Rechnung prüft, soll die Rückmeldung verstehen und damit weiterarbeiten können.
Die neue Fehlersammlung führt diesen Gedanken weiter. Sie bietet Platz für ausführliche Erklärungen, technische Beispiele, Zusammenhänge und gezielte Handlungsschritte. Die Beiträge lassen sich nachschlagen, im Support weitergeben und gemeinsam mit Buchhaltung oder Entwicklung nutzen.
Sie haben einen Fehlercode oder Prüfbericht vorliegen? Öffnen Sie unsere Übersicht der 50 häufigsten E-Rechnungsfehler und finden Sie die passende Erklärung.




