Lösung 3 · frei
Ein Shortcode stellt den offiziellen KoSIT-Validator auf Ihre Seite. Der Besucher zieht eine E-Rechnungs-XML darauf, das Plugin prüft sie gegen genau die Schematron- und XSD-Szenarien, auf die sich das XRechnung-Ökosystem selbst verlässt, und zeigt das Urteil mit jedem Befund. Nichts verlässt Ihren Server: keine Prüf-API eines Dritten, kein Konto, kein Schlüssel.
Echte Ausgabe, kein Mockup
Ein abgelehnter Bericht: vier Fehler, jeder mit seiner Regel-Kennung, dem Regeltext im Klartext und der genauen Fundstelle im Dokument. Getrennt nach Fehlern, Warnungen und Hinweisen.
Kein Nachbau
Das Plugin führt die Java-Anwendung aus, die das deutsche XRechnung-Projekt selbst ausliefert – und für die PEPPOL und Factur-X ihre eigenen Szenario-Konfigurationen veröffentlichen. Keine nachgebaute Annäherung an die Regeln.
XRechnung 3.0.2, ZUGFeRD/Factur-X EN16931 samt EXTENDED und PEPPOL BIS Billing 3.0. Jedes konfigurierte Szenario wird der Reihe nach versucht, ein Upload also gegen jedes Format geprüft, das plausibel infrage kommt. Ein Format, das nicht installiert ist, wird übersprungen statt als Fehler behandelt.
Der KoSIT-Validator endet auch dann mit einem Fehlercode, wenn er ein Dokument korrekt als ungültig erkennt – bei einer fehlerhaften Rechnung ist das der erwartete Ausgang. Das Urteil hängt deshalb nie am Exitcode allein, sondern daran, ob überhaupt ein Bericht entstanden ist.
Was hinten herauskommt
Die rohe Berichts-XML des KoSIT-Validators steht immer als Download bereit – für alle, die das maßgebliche Artefakt selbst brauchen, etwa zur Ablage oder zur Weitergabe.
Ist der Validation Explainer daneben aktiv, erscheint derselbe Bericht stattdessen in Klartext: jeder Befund mit seinem EN-16931-Business-Term beschriftet, in einem verschachtelten Shadow DOM, damit dessen Typografie nicht in die umgebende Seite ausläuft. Kommt der Explainer mit einem Bericht nicht zurecht, wird die rohe KoSIT-HTML gezeigt statt gar nichts.
Angenommen: die Prüfschritte einzeln aufgeführt – XML-Schema, Schematron-Regeln, val.xml.
Der Dokumentinhalt daneben – die beanstandete Zeile ist direkt im Baum markiert.
Ein Vorgang, der Sekunden braucht
Anders als Viewer und Explainer kommt dieses Plugin nicht ohne temporäre Datei aus: die Validator-Kommandozeile verlangt einen Dateipfad, keine Daten über die Standardeingabe. Der Ausgleich dafür ist ein frisches, unvorhersehbar benanntes Verzeichnis je Anfrage – außerhalb des Uploads-Ordners, gelöscht samt Bericht in einem finally-Block, der auch dann läuft, wenn die Prüfung fehlschlug oder eine Ausnahme warf.
Ein hängender Validator kann keinen Worker blockieren: die Ausgabekanäle des Prozesses werden nicht-blockierend in derselben Schleife abgeschöpft, die auch das Zeitlimit überwacht – nicht erst, wenn der Prozess fertig ist. Der Prozessaufruf selbst läuft im Array-Modus statt über eine zusammengesetzte Shell-Zeile, was Escaping-Fallstricke bei Windows-Pfaden vollständig vermeidet.
Der Validator liefert das Urteil, der Validation Explainer macht daraus Sätze, die man ohne Schematron-Kenntnisse lesen kann. Zusammen sind das zwei Plugins und ein Upload.