Auch Feldnummern (BT-10), Begriffe (Leitweg) oder einen ganzen Prüfbericht einfügen.

Fehler XML-Schema CII und UBL Rang 1 von 353

cvc-complex-type.2.4.a: Unerwartetes Element – falsche Reihenfolge oder falscher Name

15,6 % der ungültigen Prüfungen enthalten diesen Fehler5.745 von 36.827 PrüfungenZeitraum 08.01.2026–17.11.2026

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.

Regelkennungcvc-complex-type.2.4.a
HerkunftXML-Schema (XSD) der Syntax CII bzw. UBL; Meldung des XML-Parsers
SchwereFehler – die Rechnung ist ungültig
Betroffene Felderkein bestimmtes Feld – betrifft den Aufbau der Datei
Gilt füralle E-Rechnungen: XRechnung und ZUGFeRD, CII und UBL
Häufigkeitin 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 ApplicableHeaderTradeDelivery fehlt; 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:DateTimeString statt udt: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.

GefundenErwartetMeldungenBedeutung und Lösung
ApplicableHeaderTradeSettlementApplicableHeaderTradeDelivery435Lieferungs-Block fehlt. In CII zwischen ApplicableHeaderTradeAgreement und ApplicableHeaderTradeSettlement einfügen, notfalls leer.
BasisAmount, ExemptionReasonCode, ExemptionReason, CalculatedAmountElemente, die nach dem Steuersatz kommen838Steueraufschlüsselung in falscher Reihenfolge: Diese Elemente stehen hinter RateApplicablePercent. Reihenfolge: CalculatedAmount, TypeCode, ExemptionReason, BasisAmount, CategoryCode, ExemptionReasonCode, …, RateApplicablePercent.
DateTimeStringDateTimeString320Falscher Namensraum beim Datum. In IssueDateTime und ähnlichen Datumsfeldern gehört udt:DateTimeString hinein.
ApplicableHeaderTradeAgreementIncludedSupplyChainTradeLineItem285Keine Rechnungsposition (ZUGFeRD-Schema, dort ist mindestens eine Position Pflicht). Positionen stehen in CII vor ApplicableHeaderTradeAgreement.
BillingSpecifiedPeriodElemente nach den Summen196Leistungszeitraum steht zu weit hinten. Er gehört nach ApplicableTradeTax und vor die Zahlungsbedingungen und Summen.
PostalAddress (UBL)PartyLegalEntity, Contact188Anschrift steht in UBL zu weit hinten. Reihenfolge in Party: EndpointID, PartyIdentification, PartyName, PostalAddress, PartyTaxScheme, PartyLegalEntity, Contact.
SpecifiedTradePaymentTermsSpecifiedTradeSettlementPaymentMeans, ApplicableTradeTax176Zahlungsbedingungen stehen vor Zahlungsart oder Steuern. Reihenfolge: PaymentMeans, ApplicableTradeTax, BillingSpecifiedPeriod, AllowanceCharge, PaymentTerms, Summen.
PostcodeCodeCountryID u. a.79Postleitzahl 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

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.

Warenkorb