SCHEMA-001
XML nicht wohlgeformt (Parserfehler, keine Regel-ID)
Was dieser Fehler bedeutet
SCHEMA-001 ist keine offizielle Regel-ID; docutools.pro verwendet sie als Bezeichnung für Dateien, die sich gar nicht als XML lesen lassen. Der KoSIT-Validator bricht dann beim ersten Schritt ab: Sein Bericht zeigt kein Szenario und keine Regel, nur eine Parsermeldung wie „The entity name must immediately follow the '&' in the entity reference“ mit Zeile und Spalte, und die Datei wird nicht angenommen (aktuelle KoSIT-Versionen formulieren das als „Das Dokument sollte nicht automatisiert angenommen werden“, ältere als Empfehlung zur Ablehnung). Häufige Ursachen sind ein nicht maskiertes & oder < in einem Textwert, ein nie geschlossenes Tag, falsche Verschachtelung, Text vor der XML-Deklaration oder eine Kodierungsangabe, die nicht zur Datei passt.
Warum dieser Fehler auftritt
Wohlgeformtheit ist die grundlegendste Anforderung: Jedes Start-Tag hat ein passendes End-Tag, Elemente sind korrekt verschachtelt, es gibt genau ein Wurzelelement, und Zeichen mit Sonderbedeutung sind maskiert. Scheitert etwas davon, kann weder das Schema noch eine Schematron-Regel laufen. Die häufigste Ursache in der Praxis ist ein Firmen- oder Produktname mit Et-Zeichen („Meyer & Sohn“), der per Zeichenkettenverkettung statt mit einer XML-Bibliothek ins XML geschrieben wurde. Weitere: eine abgeschnittene Datei nach einem abgebrochenen Upload oder einer Größenbegrenzung in einer Schnittstelle; Log-Ausgaben oder eine PHP-Warnung vor der XML-Deklaration; zwei XML-Dokumente in einer Datei; oder eine als Windows-1252 gespeicherte Datei, die UTF-8 deklariert und am ersten Umlaut scheitert. Ein UTF-8-Byte-Order-Mark (BOM) akzeptiert der KoSIT-Validator, manche Upload-Portale und ältere Parser lehnen es aber ab. Ohne BOM zu speichern ist deshalb die sicherere Wahl.
Wie Sie ihn beheben
Öffnen Sie die Datei in einem XML-fähigen Editor, der Zeile und Spalte des ersten Fehlers anzeigt, und beheben Sie die Syntax. Maskieren Sie Sonderzeichen in Textwerten: & → &, < → <, > → > sowie " → " in Attributen. Speichern Sie als UTF-8 und achten Sie darauf, dass die Deklaration encoding="UTF-8" lautet.
Schritt für Schritt
1) Öffnen Sie die Datei in einem XML-fähigen Editor (etwa VS Code mit XML-Erweiterung, oXygen oder XMLSpy); er zeigt Zeile und Spalte des ersten Fehlers. 2) Maskieren Sie Sonderzeichen in allen Textwerten: & → &, < → <, > → > sowie " → " in Attributwerten. 3) Prüfen Sie, dass jedes öffnende Tag ein passendes, korrekt verschachteltes schließendes Tag hat und es nur ein Wurzelelement gibt. 4) Entfernen Sie alles, was vor <?xml version="1.0" encoding="UTF-8"?> steht. 5) Speichern Sie als UTF-8 und achten Sie darauf, dass die deklarierte Kodierung passt. 6) Beheben Sie die Ursache im Generator: Erzeugen Sie das XML mit einer Bibliothek, die Werte automatisch maskiert, statt Zeichenketten zu verketten. 7) Prüfen Sie erneut; erst eine wohlgeformte Datei erreicht Schema- und Schematron-Prüfung.
<?xml version="1.0" encoding="UTF-8"?> <!-- wrong: <cbc:RegistrationName>Meyer & Sohn GmbH</cbc:RegistrationName> --> <cbc:RegistrationName>Meyer & Sohn GmbH</cbc:RegistrationName>
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-001, und korrigiert unterstützte Felder mit einem GoBD-Prüfpfad.
Smart Repair öffnenHäufig gestellte Fragen
Warum zerstört ein Firmenname mit „&“ das XML?
Weil „&“ in XML eine Entitätsreferenz einleitet. Ein wörtliches Et-Zeichen im Text muss als & geschrieben werden, aus „Meyer & Sohn“ wird also „Meyer & Sohn“. Dasselbe gilt für <.
Ist ein Byte Order Mark (BOM) ein Problem?
Für den KoSIT-Validator nicht, er akzeptiert ein UTF-8-BOM. Manche Portale und ältere Parser lehnen es aber ab. Speichern Sie deshalb sicherheitshalber als UTF-8 ohne BOM.
Warum zeigt der Bericht keine Regel-ID?
Regel-IDs stammen aus dem Schematron, das nur auf einem gelesenen Dokument laufen kann. Ein Parserfehler passiert vorher, deshalb gibt es nur die Parsermeldung mit Zeile und Spalte.
Verwandte Fehler
Andere häufig auftretende Validierungsfehler