Startseite › Wissen › cvc-complex-type.2.4.a

cvc-complex-type.2.4.a: Element an falscher Stelle (XML-Schema)

Das ist kein Geschäftsregel-, sondern ein XML-Schemafehler: Die Datei passt nicht zur Struktur von UBL bzw. CII. Meist steht ein Element an der falschen Stelle – im XML-Schema ist die Reihenfolge der Elemente fest vorgegeben – oder ein Pflichtelement davor fehlt. Die Meldung nennt das gefundene Element und die an dieser Stelle erwarteten Elemente.

Original-Meldung (Beispiel)

Invalid content was found starting with element '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":DueDate}'. One of '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":CopyIndicator, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":UUID, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":IssueDate}' is expected.

Schemafehler stammen aus der Prüfung gegen die offiziellen XML-Schemas (XSD) von UBL 2.1 bzw. CII D16B, die Meldungstexte vom XML-Parser (englisch).

Typische Ursachen

Selbst erzeugtes XML mit vertauschter Reihenfolge (z. B. Fälligkeitsdatum vor Rechnungsdatum).
Ein Element aus dem falschen Namensraum (z. B. cac: statt cbc:).
Tippfehler im Elementnamen.

So beheben Sie den Fehler

In der Meldung nach „One of '{…}' is expected“ schauen – das sind die an dieser Stelle erlaubten Elemente.
Reihenfolge an das offizielle Schema anpassen; Beispiel-Dateien aus der KoSIT-Testsuite helfen als Vorlage.
Bei Fehlern aus einer Standardsoftware: Hersteller informieren – Schemafehler lassen sich in der Regel nicht durch Stammdaten beheben.

Beispiel: vorher und nachher

Fehlerhaft

<cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
<cbc:ID>RE-2026-0042</cbc:ID>
<!-- hier fehlt die Angabe -->
<cbc:DueDate>2026-10-15</cbc:DueDate>
<cbc:IssueDate>2026-10-01</cbc:IssueDate>
<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>

Korrigiert

<cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
<cbc:ID>RE-2026-0042</cbc:ID>
<cbc:IssueDate>2026-10-01</cbc:IssueDate>
<cbc:DueDate>2026-10-15</cbc:DueDate>
<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>

Ausschnitt aus einer vollständigen XRechnung 3.0 (UBL). Ergebnis mit dem KoSIT-Validator: Die fehlerhafte Variante erzeugt cvc-complex-type.2.4.a und wird abgelehnt; die korrigierte Variante wird akzeptiert.

Häufige Fragen

Warum sehe ich bei einem Schemafehler keine anderen Fehler?

Der KoSIT-Validator prüft zuerst das Schema. Ist die Datei nicht schemakonform, werden die Geschäftsregeln (BR-…) nicht mehr zuverlässig geprüft.

Hintergrund: E-Rechnung empfangen und prüfen