SCHEMA-002
Falsches Wurzelelement oder Namespace (kein passendes Szenario, keine Regel-ID)
Was dieser Fehler bedeutet
SCHEMA-002 ist keine offizielle Regel-ID; docutools.pro verwendet sie als Bezeichnung für wohlgeformte Dateien, die der KoSIT-Validator keinem Prüfszenario zuordnen kann. Der Validator wählt das Szenario anhand von Wurzelelement, Namespace und Spezifikationskennung BT-24. Passt nichts, meldet der Bericht, dass kein Szenario gefunden wurde, zeigt keine Regel-ID, und die Datei wird nicht angenommen (aktuelle KoSIT-Versionen: „Das Dokument sollte nicht automatisiert angenommen werden“). Für XRechnung in UBL muss das Wurzelelement Invoice im Namespace urn:oasis:names:specification:ubl:schema:xsd:Invoice-2 sein (oder CreditNote in ...:CreditNote-2); für CII ist es rsm:CrossIndustryInvoice.
Warum dieser Fehler auftritt
Die Konfiguration des KoSIT-Validators für XRechnung 3.0.x (Release vom 31. August 2026) enthält Szenarien für XRechnung (UBL-Invoice, UBL-CreditNote, CII), die XRechnung-Extension (UBL-Invoice, CII), XRechnung CVD für saubere Fahrzeuge (UBL-Invoice, UBL-CreditNote, CII) und die reine EN 16931 mit der Kennung urn:cen.eu:en16931:2017 (UBL-Invoice, UBL-CreditNote, CII; diese prüfen nur die EN-16931-Regeln, keine XRechnung-Regeln). Jedes Szenario erkennt das Wurzelelement in seinem Namespace zusammen mit dem exakten Wert von BT-24. Häufige Gründe, warum nichts passt: ein falsch geschriebener oder versionierter Namespace (etwa Invoice-2.1); das Wurzelelement hat gar keinen Namespace; die Präfixe cac und cbc zeigen auf falsche URIs; eine Gutschrift steckt in Invoice statt CreditNote; BT-24 fehlt, hat ein Leerzeichen am Ende oder enthält noch eine Kennung aus XRechnung 2.x; eine ZUGFeRD-Datei mit einer Profilkennung wie BASIC oder EXTENDED wird gegen die XRechnung-Konfiguration geprüft; oder es wurde ein PDF statt des eingebetteten XML hochgeladen. Weil kein Schematron läuft, enthält der Bericht keinen der bekannten BR-Codes. Das lässt diesen Fehler oft rätselhaft wirken.
Wie Sie ihn beheben
Verwenden Sie das passende Wurzelelement mit Namespace für Ihre Syntax und Ihren Dokumenttyp, und setzen Sie BT-24 auf die exakte Kennung für XRechnung 3.0. Mischen Sie UBL und CII nicht in einem Dokument.
Schritt für Schritt
1) Klären Sie, welche Syntax der Empfänger erwartet: UBL oder CII (für XRechnung sind beide zulässig). 2) UBL-Rechnung: Wurzelelement Invoice mit Standard-Namespace urn:oasis:names:specification:ubl:schema:xsd:Invoice-2 und den üblichen cac/cbc-Namespaces. 3) UBL-Gutschrift: Wurzelelement CreditNote mit urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2. 4) CII: rsm:CrossIndustryInvoice mit den UN/CEFACT-Namespaces für rsm, ram und udt. 5) Setzen Sie BT-24 exakt auf urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0 (siehe BR-1 und BR-DE-21). 6) Bei einem ZUGFeRD-PDF extrahieren Sie das eingebettete XML; ein XRechnung-Validator prüft XML, kein PDF. 7) Prüfen Sie erneut; sobald ein Szenario passt, listet der Bericht die Schema- und Schematron-Schritte auf.
<!-- UBL invoice -->
<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0</cbc:CustomizationID>
<!-- ... -->
</Invoice>
<!-- CII invoice -->
<rsm:CrossIndustryInvoice
xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100"
xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100"
xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100">
<!-- ... -->
</rsm:CrossIndustryInvoice>Automatisch beheben
Laden Sie Ihre Rechnung in unsere Smart-Repair-Engine hoch. Sie prüft die Datei gegen das vollständige KoSIT-Regelwerk, auch auf SCHEMA-002, und korrigiert unterstützte Felder mit einem GoBD-Prüfpfad.
Smart Repair öffnenHäufig gestellte Fragen
Welchen Namespace verwendet XRechnung?
Für UBL-Rechnungen urn:oasis:names:specification:ubl:schema:xsd:Invoice-2, für UBL-Gutschriften den CreditNote-2-Namespace. Bei CII ist das Wurzelelement rsm:CrossIndustryInvoice in urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100.
Kann ich UBL und CII mischen?
Nein. Ein Dokument ist von Anfang bis Ende entweder UBL oder CII. Wählen Sie eine Syntax und verwenden Sie sie durchgehend.
Mein Namespace stimmt. Warum gibt es trotzdem kein Szenario?
Prüfen Sie BT-24. Das Szenario verlangt auch die exakte Kennung für XRechnung 3.0; eine alte 2.x-Kennung oder eine ZUGFeRD-Profilkennung für BASIC oder EXTENDED führt zum selben Ergebnis. Die reine EN-16931-Kennung urn:cen.eu:en16931:2017 passt dagegen zu einem EN-16931-Szenario, das keine XRechnung-Regeln prüft.
Verwandte Fehler
Andere häufig auftretende Validierungsfehler