cvc-complex-type.2.4.a: Unerwartetes Element in der XML-Datei
Allgemeine Meldung der XML-Schemaprüfung. Tritt bei XRechnung und ZUGFeRD in beiden Syntaxen (CII und UBL) auf.
Was die Meldung bedeutet
Jede E-Rechnung wird in zwei Schritten geprüft. Zuerst prüft das XML-Schema (XSD), ob die Datei richtig aufgebaut ist: welche Elemente es gibt, in welcher Reihenfolge sie stehen und wie oft sie vorkommen dürfen. Erst danach folgen die Geschäftsregeln wie BR-CO-10 oder BR-DE-15.
cvc-complex-type.2.4.a heißt: Beim Lesen der Datei ist das Prüfprogramm auf ein Element gestoßen, das an dieser Stelle nicht erwartet wurde. Die vollständige Meldung lautet meist sinngemäß „Invalid content was found starting with element … One of … is expected“. Sie nennt also das Element, an dem die Prüfung hängen bleibt, und die Elemente, die stattdessen an dieser Stelle stehen dürften.
Solange dieser Fehler besteht, ist die Datei keine gültige E-Rechnung. Rechnungseingangsportale lehnen sie in der Regel ab.
Häufige Ursachen
- Falsche Reihenfolge: Sowohl CII als auch UBL schreiben die Reihenfolge der Elemente fest vor. Steht zum Beispiel in CII die Steuerregistrierung des Verkäufers (USt-IdNr.) vor seiner Anschrift, meldet die Prüfung genau diesen Fehler.
- Tippfehler oder falsche Groß-/Kleinschreibung im Elementnamen, etwa „ram:Buyerreference“ statt „ram:BuyerReference“.
- Falscher Namensraum: Das Element trägt das Präfix eines anderen Namensraums (zum Beispiel „cbc:“ statt „cac:“ in UBL) oder der Namensraum ist im Kopf der Datei anders erklärt.
- Ein Element kommt häufiger vor als erlaubt, zum Beispiel zwei Rechnungsdaten im Kopf.
So beheben Sie den Fehler
- Lesen Sie die vollständige Meldung: Sie nennt das gefundene Element und die erwarteten Elemente. Daraus ergibt sich meist direkt, ob ein Element fehlt, falsch heißt oder an die falsche Stelle gerutscht ist.
- Vergleichen Sie die Reihenfolge mit einer gültigen Beispielrechnung derselben Syntax und Version. Verschieben Sie das Element an die vorgesehene Stelle.
- Entsteht die Datei in Ihrer Rechnungssoftware, liegt der Fehler im Export. Melden Sie ihn dem Hersteller mit der vollständigen Meldung. Eigene Anpassungen am Export sollten Sie nach jeder Änderung neu prüfen.
- Haben Sie keinen Einfluss auf den Export, können Sie die Rechnung aus der PDF neu als E-Rechnung erzeugen lassen, etwa mit unserem Konverter.
Beispiel
CII: Reihenfolge im Verkäuferblock (CII, z. B. ZUGFeRD)
Fehlerhaft
<ram:SellerTradeParty>
<ram:Name>Muster GmbH</ram:Name>
<ram:SpecifiedTaxRegistration>
<ram:ID schemeID="VA">DE123456789</ram:ID>
</ram:SpecifiedTaxRegistration>
<ram:PostalTradeAddress>…</ram:PostalTradeAddress>
</ram:SellerTradeParty>Richtig
<ram:SellerTradeParty>
<ram:Name>Muster GmbH</ram:Name>
<ram:PostalTradeAddress>…</ram:PostalTradeAddress>
<ram:SpecifiedTaxRegistration>
<ram:ID schemeID="VA">DE123456789</ram:ID>
</ram:SpecifiedTaxRegistration>
</ram:SellerTradeParty>Rechnung prüfen oder neu erzeugen
Unser kostenloser Validator prüft XRechnung und ZUGFeRD mit den offiziellen Regeln und erklärt jede Meldung auf Deutsch. Ist die Datei nicht zu retten, erzeugen Sie aus der PDF-Rechnung eine neue, gültige E-Rechnung.
Häufige Fragen zu cvc-complex-type.2.4.a
Was ist der Unterschied zu cvc-complex-type.2.4.b?
2.4.a meldet ein Element, das an dieser Stelle nicht stehen darf. 2.4.b meldet, dass ein Element unvollständig ist, weil ein Pflicht-Unterelement fehlt. 2.4.d bedeutet, dass nach dem Ende des erlaubten Inhalts noch ein Element folgt.
Warum meldet die Prüfung danach keine weiteren Fehler?
Schlägt die Schemaprüfung fehl, laufen die Geschäftsregeln oft gar nicht erst oder nur eingeschränkt. Nach der Korrektur können deshalb neue Meldungen wie BR-CO-10 auftauchen. Das ist kein neuer Fehler, sondern die nächste Prüfstufe.
Kann ich die Datei trotzdem verschicken?
Davon raten wir ab. Eine Datei, die schon am Schema scheitert, ist keine gültige E-Rechnung und wird von Portalen der Verwaltung und vielen Unternehmen automatisch abgelehnt.