UBL/Peppol-Rechnungsvalidator

Die Form prüfen, bevor das Netzwerk es für Sie tut

Der teure Weg, herauszufinden, dass eine Rechnungsdatei defekt ist, ist, sie zu verschicken: Sie reist zu Ihrem Kunden oder einem Access Point, wird Stunden oder Tage später zurückgewiesen, und die Zahlungsfrist beginnt von vorn. Der günstige Weg sind zuerst dreißig Sekunden hier. Dieser Validator beantwortet die unverblümten, nützlichen Fragen: Ist die Datei überhaupt wohlgeformtes XML, handelt es sich tatsächlich um eine UBL-Rechnung, und sind die Felder vorhanden, die jede lesbare Rechnung braucht — Nummer, Daten, beide Parteien, Positionen und Summen. Dateien werden im Arbeitsspeicher des Servers geprüft und sofort verworfen, was der angemessene Umgang mit einem Dokument ist, das Namen, Beträge und Bankdaten trägt. Besonders in zwei Situationen macht sich das bezahlt: bei einem kleinen Unternehmen, das seine ersten UBL-Rechnungen aus einer Vorlage oder einem unvertrauten ERP-Modul erzeugt, und bei einem Entwickler, der eine Export-Pipeline testet und vor dem Kontakt mit dem echten Netzwerk schnell eine externe Meinung zur Ausgabe haben möchte.

Was eine Strukturprüfung ist — und was Schematron ist

Ehrlichkeit zählt hier. Die offizielle Peppol-BIS-Billing-3.0-Validierung ist ein Schematron-Regelwerk: hunderte Geschäftsregeln, die zum Beispiel prüfen, ob USt-Kategoriecodes stimmig sind und die Steuersummen mit den Positionssummen übereinstimmen. Dieses Tool führt diese Regeln nicht aus. Lesen Sie die beiden Ergebnisse entsprechend: Ein Fehlschlag hier ist endgültig — eine Datei, die sich nicht parsen lässt oder Pflichtfelder vermissen lässt, wird überall scheitern, korrigieren Sie sie also vor dem Versand. Ein Bestehen hier bedeutet, dass die Form brauchbar ist, nicht, dass jede Geschäftsregel erfüllt ist; das Netzwerk kann sie wegen eines Regelverstoßes immer noch zurückweisen. Erst strukturell, dann Schematron, ist die natürliche Prüfreihenfolge. Die Grenze ist bewusst gezogen, nicht aus Bequemlichkeit: Die offiziellen Regelwerke sind versioniert und zentral gepflegt, und sie richtig auszuführen ist die Aufgabe der Peppol-Infrastruktur selbst — das schlecht nachzuahmen würde Ihnen schlechter dienen, als die Grenze klar zu benennen.

Die Fehler, die uns tatsächlich begegnen

Die meisten zurückgewiesenen Dateien fallen in eine Handvoll Muster. Die Datei ist eine Gutschrift statt einer Rechnung — ein anderer UBL-Dokumenttyp, den dieser Validator noch nicht abdeckt. Es ist ein Factur-X-PDF statt reiner XML — die Rechnung ist in ein PDF eingebettet und muss zuerst mit dem Factur-X-Tool auf dieser Website extrahiert werden. Sie wurde irgendwo auf dem Weg per E-Mail abgeschnitten oder neu kodiert, sodass sich die XML-Datei nicht mehr parsen lässt. Oder ein ERP-Export hat verpflichtende Parteien- oder Summenfelder leer gelassen, weil ein Stammdatensatz unvollständig war. Der Validator benennt, was fehlt, was meist direkt darauf hinweist, welcher dieser Fälle vorliegt. Eine subtilere Variante lohnt sich zu kennen: Eine Datei, die sich in einem Texteditor problemlos öffnen lässt, kann trotzdem nicht parsen, weil ein E-Mail-Gateway oder ein Kopieren-und-Einfügen-Schritt die Zeichenkodierung geändert hat — für das Auge unsichtbar, für XML tödlich. Exportieren Sie in diesem Fall lieber erneut aus dem Quellsystem, statt von Hand zu reparieren.

Derselbe Parser wie beim PDF-Renderer — und wann Sie Ihren Anbieter anrufen sollten

Dieser Validator teilt sich seinen Parser, Zeile für Zeile, mit dem Tool UBL/Peppol-Rechnung in PDF hier auf der Website. Das ergibt einen verlässlichen kleinen Arbeitsablauf: die Datei validieren, dann rendern und die Rechnung so lesen, wie ein Mensch es täte — eine falsche IBAN oder eine absurde Summe fällt auf einer Seite oft leichter auf als in XML. Und wissen Sie, wo die Grenze liegt: Besteht eine Datei hier, rendert sie sinnvoll und wird trotzdem vom Peppol-Netzwerk zurückgewiesen, liegt das Problem auf Ebene der Geschäftsregeln oder der Übertragung. Dieses Gespräch gehört zu Ihrem Access Point oder Softwareanbieter, der den offiziellen Validierungsbericht einsehen kann — bringen Sie dessen Fehlermeldung mit, denn sie benennt die genaue Regel, die ausgelöst hat.

Was hier tatsächlich geprüft wird

Dies bestätigt, dass die Datei wohlgeformtes XML ist, ein UBL-Invoice-Wurzelelement besitzt und die Felder enthält, die eine lesbare Rechnung benötigt: eine Rechnungsnummer, Datumsangaben, Lieferant und Kunde als Parteien, Rechnungspositionen und Summen. Es handelt sich um eine strukturelle Plausibilitätsprüfung, nicht um die offizielle Peppol-BIS-Billing-3.0-Schematron-Validierung — nicht jeder Verstoß gegen eine Geschäftsregel wird erkannt (z. B. nicht korrekt addierte Steuersummen), sondern nur, ob die grundlegende Struktur überhaupt verwendbar ist.