Die Datei verstößt gegen den Aufbau, den das XML-Schema vorschreibt: An einer Stelle steht ein Element, das dort nicht erwartet wird. Meist ist die Reihenfolge falsch, ein Pflicht-Element davor fehlt oder der Namensraum stimmt nicht. Die Meldung nennt das gefundene und die erwarteten Elemente.
| Regelkennung | cvc-complex-type.2.4.a |
| Herkunft | XML-Schema (XSD) der Syntax CII bzw. UBL; Meldung des XML-Parsers |
| Schwere | Fehler – die Rechnung ist ungültig |
| Betroffene Felder | kein bestimmtes Feld – betrifft den Aufbau der Datei |
| Gilt für | alle E-Rechnungen: XRechnung und ZUGFeRD, CII und UBL |
| Häufigkeit | in 5.745 von 36.827 ungültigen Prüfungen (15,6 %) – davon XRechnung 2.142, ZUGFeRD 3.603 |
Fehlermeldung
Die Meldung ist englisch und nennt zwei Dinge: das Element, bei dem der Parser gestolpert ist (starting with element), und die Elemente, die er an dieser Stelle erwartet hätte (One of … is expected). Der Teil in geschweiften Klammern ist der Namensraum. Bei ZUGFeRD-Prüfungen steht zusätzlich die Zeilen- und Spaltennummer in der Datei dabei.
KoSIT-Prüftool (Beispiel)
cvc-complex-type.2.4.a: Invalid content was found starting with element '{"urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100":ApplicableHeaderTradeSettlement}'. One of '{"urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100":ApplicableHeaderTradeDelivery}' is expected.
Mustang, ZUGFeRD (Beispiel)
schema validation fails:org.xml.sax.SAXParseException; lineNumber: 34; columnNumber: 60; cvc-complex-type.2.4.a: Invalid content was found starting with element '…'. One of '…' is expected.
Was die Regel verlangt
Das XML-Schema legt für jedes Element fest, welche Unterelemente es haben darf, in welcher Reihenfolge und wie oft. Der Parser liest die Datei von oben nach unten. Trifft er auf ein Element, das an dieser Stelle nicht vorgesehen ist, meldet er cvc-complex-type.2.4.a.
Die Liste der erwarteten Elemente sagt, was an dieser Stelle stehen müsste. Steht dort ein Pflicht-Element, fehlt es. Stehen dort nur Elemente, die eigentlich nach dem gefundenen kommen, ist die Reihenfolge vertauscht.
Es handelt sich um einen Fehler im Aufbau, nicht im Inhalt. Beheben Sie Schemafehler immer zuerst und prüfen Sie dann erneut. Beim XRechnung-Prüftool der KoSIT bricht ein Schemafehler die weitere Prüfung ab: Die Regeln der EN 16931 und der XRechnung werden erst nach der Korrektur geprüft, dann können weitere Fehler erscheinen. Das ZUGFeRD-Prüfwerkzeug Mustang prüft in manchen Fällen weiter; findet es verschobene Elemente nicht, meldet es zusätzliche Fehler, die nach der Korrektur verschwinden.
Typische Ursachen
- Reihenfolge vertauscht. Das häufigste Muster. Beispiel: In der Steueraufschlüsselung steht der Steuersatz (
RateApplicablePercent) vor dem Steuerbasisbetrag (BasisAmount), richtig ist umgekehrt. - Pflicht-Element fehlt davor. Der Parser erwartet ein Element, das zwingend kommen muss, findet aber schon das nächste. Beispiel: Der Lieferungs-Block
ApplicableHeaderTradeDeliveryfehlt; er ist in CII Pflicht, auch wenn er leer ist. - Falscher Namensraum. Das Element heißt richtig, gehört aber zum falschen Namensraum, zum Beispiel
ram:DateTimeStringstattudt:DateTimeString. In der Meldung steht dann das gleiche Element als gefunden und als erwartet. - Rechnung ohne Position. Im ZUGFeRD-Schema ist mindestens eine Position Pflicht. Fehlt sie, findet der Parser die Kopfdaten zu früh. Dann meldet der Validator meist auch BR-16.
Die häufigsten Fälle in unseren Prüfungen
Ausgewertet wurden 9.896 Meldungen dieses Fehlers (08.01.–18.11.2026), gezählt nach gefundenem und erwartetem Element. Ein Prüfbericht kann mehrere Meldungen enthalten.
| Gefunden | Erwartet | Meldungen | Bedeutung und Lösung |
|---|---|---|---|
ApplicableHeaderTradeSettlement | ApplicableHeaderTradeDelivery | 435 | Lieferungs-Block fehlt. In CII zwischen ApplicableHeaderTradeAgreement und ApplicableHeaderTradeSettlement einfügen, notfalls leer. |
BasisAmount, ExemptionReasonCode, ExemptionReason, CalculatedAmount | Elemente, die nach dem Steuersatz kommen | 838 | Steueraufschlüsselung in falscher Reihenfolge: Diese Elemente stehen hinter RateApplicablePercent. Reihenfolge: CalculatedAmount, TypeCode, ExemptionReason, BasisAmount, CategoryCode, ExemptionReasonCode, …, RateApplicablePercent. |
DateTimeString | DateTimeString | 320 | Falscher Namensraum beim Datum. In IssueDateTime und ähnlichen Datumsfeldern gehört udt:DateTimeString hinein. |
ApplicableHeaderTradeAgreement | IncludedSupplyChainTradeLineItem | 285 | Keine Rechnungsposition (ZUGFeRD-Schema, dort ist mindestens eine Position Pflicht). Positionen stehen in CII vor ApplicableHeaderTradeAgreement. |
BillingSpecifiedPeriod | Elemente nach den Summen | 196 | Leistungszeitraum steht zu weit hinten. Er gehört nach ApplicableTradeTax und vor die Zahlungsbedingungen und Summen. |
PostalAddress (UBL) | PartyLegalEntity, Contact | 188 | Anschrift steht in UBL zu weit hinten. Reihenfolge in Party: EndpointID, PartyIdentification, PartyName, PostalAddress, PartyTaxScheme, PartyLegalEntity, Contact. |
SpecifiedTradePaymentTerms | SpecifiedTradeSettlementPaymentMeans, ApplicableTradeTax | 176 | Zahlungsbedingungen stehen vor Zahlungsart oder Steuern. Reihenfolge: PaymentMeans, ApplicableTradeTax, BillingSpecifiedPeriod, AllowanceCharge, PaymentTerms, Summen. |
PostcodeCode | CountryID u. a. | 79 | Postleitzahl steht hinter dem Ort. In CII kommt PostcodeCode als erstes Element der Anschrift. |
XML-Beispiel
CII (XRechnung, ZUGFeRD)
Falsch – Steuersatz vor Basisbetrag
<ram:ApplicableTradeTax>
<ram:CalculatedAmount>19.00</ram:CalculatedAmount>
<ram:TypeCode>VAT</ram:TypeCode>
<ram:CategoryCode>S</ram:CategoryCode>
<ram:RateApplicablePercent>19</ram:RateApplicablePercent>
<ram:BasisAmount>100.00</ram:BasisAmount>
</ram:ApplicableTradeTax>
Richtig
<ram:ApplicableTradeTax>
<ram:CalculatedAmount>19.00</ram:CalculatedAmount>
<ram:TypeCode>VAT</ram:TypeCode>
<ram:BasisAmount>100.00</ram:BasisAmount>
<ram:CategoryCode>S</ram:CategoryCode>
<ram:RateApplicablePercent>19</ram:RateApplicablePercent>
</ram:ApplicableTradeTax>
UBL
Falsch – Anschrift hinter den Steuerangaben
<cac:Party>
<cac:PartyName>…</cac:PartyName>
<cac:PartyTaxScheme>…</cac:PartyTaxScheme>
<cac:PostalAddress>…</cac:PostalAddress>
<cac:PartyLegalEntity>…</cac:PartyLegalEntity>
</cac:Party>
Richtig
<cac:Party>
<cac:PartyName>…</cac:PartyName>
<cac:PostalAddress>…</cac:PostalAddress>
<cac:PartyTaxScheme>…</cac:PartyTaxScheme>
<cac:PartyLegalEntity>…</cac:PartyLegalEntity>
</cac:Party>
Die Reihenfolge ist im Schema festgelegt, nicht in der Norm EN 16931. Maßgeblich sind das CII-Schema (UN/CEFACT D16B in der Fassung für Factur-X/ZUGFeRD bzw. XRechnung) und das UBL-2.1-Schema.
So beheben Sie den Fehler
Ich erstelle Rechnungen
Diesen Fehler können Sie in der Regel nicht selbst beheben – er entsteht im Programm, das die Datei schreibt. Schicken Sie dem Hersteller den Prüfbericht mit der Meldung. Bei ZUGFeRD steht dort die Zeilennummer, die die Fehlersuche erleichtert.
Ich entwickle Software
Lesen Sie in der Meldung, welches Element erwartet wird. Ist es ein Pflicht-Element, ergänzen Sie es. Sonst schreiben Sie die Elemente in der Reihenfolge des Schemas. Prüfen Sie jede erzeugte Datei vor dem Versand gegen das XSD, zum Beispiel mit dem KoSIT-Prüftool.
Ich habe so eine Rechnung erhalten
Die Datei ist technisch fehlerhaft und keine gültige E-Rechnung. Fordern Sie eine korrigierte Rechnung an und legen Sie den Prüfbericht bei.
Folgen
Die Rechnung ist ungültig. Prüfen Sie sie nach der Korrektur des Aufbaus erneut: Erst dann laufen bei XRechnung alle Regelprüfungen, und es können weitere Fehler gemeldet werden.
Zusammenhänge
Tritt oft zusammen auf mit
Keine häufigen gemeinsamen Fehler in unserer Zählung.
Gleiche Ursache oder Folgefehler
- BR-16 Rechnung ohne Rechnungsposition (BG-25): 84 % der Prüfungen mit BR-16 (keine Rechnungsposition) enthalten auch diesen Fehler – vor allem bei ZUGFeRD, dessen Schema eine Position verlangt. Das XRechnung-Schema meldet eine fehlende Position nicht als Schemafehler (maschinell geprüft).
- BR-CO-18 Umsatzsteueraufschlüsselung fehlt (BG-23): 75 % der Prüfungen mit BR-CO-18 (keine Steueraufschlüsselung) enthalten auch diesen Fehler – bei ZUGFeRD-Prüfungen. Steht die Steueraufschlüsselung an falscher Stelle, findet die Regelprüfung sie nicht. Bei XRechnung stoppt der Schemafehler die Regelprüfung, BR-CO-18 erscheint dann erst nach der Korrektur.
- BR-CO-04 Steuerkategorie der Position fehlt (BT-151): 57 % der Prüfungen mit BR-CO-04 enthalten auch diesen Fehler – vermutlich ebenfalls, weil verschobene Steuerangaben nicht gefunden werden.
Verwandte Regeln
- cvc-complex-type.2.4.b Element unvollständig: Pflicht-Unterelement fehlt
- cvc-complex-type.2.4.d Element an dieser Stelle nicht erlaubt
- cvc-complex-type.2.2 Element darf nur Text enthalten
- cvc-datatype-valid.1.2.1 Wert passt nicht zum Datentyp, z. B. Datum
Häufige Fragen
Warum ist die Reihenfolge der Elemente überhaupt wichtig?
Das XML-Schema der E-Rechnung legt sie fest. Nur so können alle Programme die Datei gleich lesen. Eine Datei in anderer Reihenfolge ist formal keine gültige E-Rechnung, auch wenn alle Angaben enthalten sind.
Ich sehe viele weitere Fehler im Prüfbericht. Welche zuerst?
Zuerst die Schemafehler (cvc-…). Danach erneut prüfen: Bei XRechnung laufen die übrigen Regelprüfungen erst dann und können weitere Fehler melden; bei ZUGFeRD verschwinden manche Folgemeldungen.
Quellen und Stand
- XML-Schema der CII-Syntax (UN/CEFACT Cross Industry Invoice D16B) und der UBL-2.1-Syntax
- Meldungstexte des XML-Parsers Apache Xerces (cvc = constraint on validity of content)
- Muster der häufigsten Fälle: eigene Auswertung der Elementnamen in 9.896 Meldungen, ohne Rechnungswerte
- XML-Beispiele maschinell geprüft am 18.11.2026 mit KoSIT-Prüftool 1.6.3 (Regeln vom 02.09.2026): das falsche Beispiel löst cvc-complex-type.2.4.a aus, die Korrektur behebt den Fehler.
- Häufigkeit: Monatsexporte der Fehlerstatistik von erechnungs-validator.de; Fehlerpaare: genaue Zählung 08.01.–18.11.2026; nur Zählungen, keine Rechnungsinhalte. Zeitraum und Stand stehen im Seitenfuß.
Fakten geprüft von Dieter Pfenning · Zuletzt von einem Menschen geprüft: 18.11.2026
Rechnung korrigiert? Prüfen Sie sie erneut – kostenlos und ohne Anmeldung.
