eInvoice Validator for KoSIT (App) – Handbuch

1 · Überblick

Die App eInvoice Validator for KoSIT ist eine Seite, die ohne Installation im Browser läuft. Sie legen eine E-Rechnung auf die Seite, den KoSIT-Validator prüft sie, und der Prüfbericht erscheint darunter. Zu jedem Befund nennt der Bericht das betroffene Feld der Rechnung und erklärt die Regel in Klartext.

Die App enthält keinen Validator. Sie schickt die Rechnung an die Quelle ihrer Prüfung. Das ist die Validator Bridge, ein kostenloses Programm, das den KoSIT-Validator auf Ihrem Rechner oder auf einem Server startet und über HTTP anbietet, eine Website mit dem Plugin eInvoice Validator for KoSIT oder eine Website mit der eInvoice API wie invoicePress.de. Alle drei bieten dieselben Adressen an. Die Quelle schickt den Bericht zurück, und die App zeigt ihn an. Ohne Quelle prüft die App nichts; kein anderer Validator springt ein.

Was die App kann:

• Sie nimmt XML-Rechnungen sowie ZUGFeRD- und Factur-X-PDFs per Ziehen und Ablegen, per Dateiauswahl oder aus der Zwischenablage an.
• Sie zeigt den Bericht des KoSIT-Validators mit Urteil, Befunden, Feldnamen, Erklärungen und dem Inhalt der Rechnung.
• Sie bietet den unveränderten Bericht als report.xml zum Herunterladen an.
• Sie spricht Deutsch, Englisch und Französisch.
• Sie liegt als Ordner und zusätzlich als eine einzige Datei vor.

Was die App nicht kann:

• Ohne eingetragene und erreichbare Quelle prüft sie nichts. Die Seite sagt dann, dass keine Quelle eingetragen ist oder dass der Prüfdienst nicht erreichbar war.
• Sie installiert weder die Bridge noch den Validator.

Voraussetzungen:

2 · Die App aufstellen

Als Ordner

1. Entpacken Sie die ZIP-Datei in einen Ordner Ihrer Wahl.
2. Öffnen Sie einvoice-validator-for-kosit.html mit einem Doppelklick, oder legen Sie den Ordner auf einen Webserver und rufen Sie die Datei über dessen Adresse auf.

Der Ordner bringt die Schriften, die Gestaltung und den Regelkatalog mit. Wie ausgeliefert lädt er nichts von einer Website.

Als einzelne Datei

1. Nehmen Sie die Datei einvoice-validator-for-kosit-one-file.html aus dem Ordner.
2. Öffnen Sie sie mit einem Doppelklick, oder laden Sie sie auf Ihren Webserver.

Die einzelne Datei bringt Englisch und die Gestaltung Kit H mit. Weitere Sprachen, die Regelkataloge, die Schriften und dieses Handbuch lädt sie von der Website, die in ihren Einstellungen unter site steht. Aus der Rechnung sendet sie dorthin nichts.

In einer Website

Im Ordner examples liegt die Seite embed-one-file-iframe.html. Sie zeigt, wie die einzelne Datei in einem Rahmen auf einer Seite Ihrer Website erscheint, ohne eigene Bildlaufleiste und mit dem Hintergrund Ihrer Seite.

3 · Die Validator Bridge einrichten

Die Bridge hat ein eigenes Handbuch (README.de.md in ihrem Paket). Für diese App kommt es auf drei Punkte an.

1. Starten Sie die Bridge mit einer Einstellungsdatei, in der der Pfad zu Ihrem KoSIT-Validator und seinen Szenarien steht (kosit.classpath, kosit.scenarios).
2. Rufen Sie im Browser http://127.0.0.1:8090/info auf. Unter kosit muss "available": true stehen.
3. Prüfen Sie, ob die Bridge die Seite der App zulässt. Das regelt der Eintrag allowed.origins in ihrer Einstellungsdatei.

Statt einer Bridge: eine Website

Eine Website, auf der das Plugin eInvoice Validator for KoSIT mit einem funktionierenden KoSIT läuft, bietet dieselbe Prüfung an. Tragen Sie unter sources.kosit als url ihre Adresse mit /wp-json/einvoice/v1 am Ende ein, zum Beispiel https://example.com/wp-json/einvoice/v1. Die Website prüft für jeden Besucher im Rahmen des Tageslimits, das ihr Plugin für Gäste festlegt; eine Rolle, die in der Tabelle „Tägliche Uploads je Rolle“ auf 0 steht, hat keinen Zugang.

Bietet eine Website die eInvoice API an, etwa invoicePress.de, tragen Sie als url deren Adresse mit /wp-json/einvoice-api/v1 am Ende ein und als key Ihren API-Schlüssel dieser Website. Damit der Browser die Antwort lesen darf, muss die eInvoice API die Seite der App unter ihren erlaubten Herkünften führen.

4 · Eine Rechnung prüfen

1. Ziehen Sie die Rechnung auf die Ablagefläche, oder klicken Sie darauf und wählen Sie die Datei aus.
2. Warten Sie, bis „Wird geprüft …“ verschwindet. Der KoSIT-Validator braucht für eine Rechnung meist wenige Sekunden.
3. Lesen Sie den Bericht. Oben steht das Urteil, darunter jeder Befund mit Feld und Erklärung, danach der Inhalt der Rechnung.
4. Klicken Sie auf report.xml herunterladen, wenn Sie den Bericht des Validators unverändert aufbewahren wollen.
5. Klicken Sie auf Zurücksetzen, um die Seite zu leeren.

Viele Rechnungen auf einmal: die Stapelprüfung

Über dem Ablagefeld stehen zwei Reiter, Einzelprüfung und Stapelprüfung. Die Stapelprüfung ist für alle, die mehr als eine Rechnung prüfen: das Unternehmen, das den Eingang eines Monats im Überblick sehen will, und den kleinen Betrieb, der seinen Monatsordner einmal durchsieht.

1. Den Reiter Stapelprüfung wählen.
2. Rechnungen in das Feld ziehen. Das Feld nimmt einzelne Dateien, einen ganzen Ordner mit Unterordnern, eine ZIP-Datei und eine E-Mail als .eml mit Anhängen. Mit Ordner wählen lässt sich ein Ordner auch über den Dateidialog wählen.
3. Jede Rechnung geht einzeln und nacheinander an den Prüfdienst aus config.js, höchstens zwei zugleich. Der Balken zeigt, wie viele geprüft sind; Abbrechen hält den Stapel an, und die schon geprüften Rechnungen bleiben stehen.
4. Die Übersicht nennt je Datei die Rechnungsnummer, den Verkäufer, das Rechnungsdatum, den Betrag, das Ergebnis ( bestanden, bestanden mit Warnungen, fehlerhaft, keine E-Rechnung, nicht geprüft ), die Zahl der Fehler und die häufigsten Regeln. Ein Klick auf eine Spaltenüberschrift sortiert, die Knöpfe darüber filtern nach dem Ergebnis, und das Suchfeld findet Dateinamen, Rechnungsnummern, Verkäufer und Regeln.
5. Ein Klick auf eine Zeile zeigt unter der Übersicht den Bericht dieser Rechnung mit der Erklärung zu jedem Befund, genau wie bei der Einzelprüfung.
6. Übersicht herunterladen ( CSV ) schreibt die Übersicht als Tabelle, die Excel ohne Einfuhrdialog öffnet: Semikolon als Trenner und Komma vor den Nachkommastellen. Eine Gutschrift trägt ein Minus, damit die Summe einer Spalte stimmt. Zusammenfassung ( HTML ) schreibt eine Seite zum Drucken oder Ablegen, die nichts nachlädt.

Eine PDF ohne eingebettete Rechnung, etwa eine eingescannte Rechnung, steht als keine E-Rechnung in der Übersicht, damit klar ist, dass sie nicht geprüft wurde. Ein Stapel nimmt höchstens 500 Dateien.

Bittet der Prüfdienst um eine Pause, weil zu viele Prüfungen in kurzer Zeit kamen, wartet die Stapelprüfung die genannte Zeit ab und macht dann weiter; über dem Balken steht, wie lange. Ist das Kontingent für den Tag aufgebraucht, hält der Stapel an, und die übrigen Rechnungen stehen als nicht geprüft in der Übersicht.

Im eInvoice Viewer

Die App bringt den Knopf Mit KoSIT prüfen für die App „eInvoice Viewer for PEPPOL & EN16931“ ab Fassung 3.0.0 mit. Der Viewer schickt die Rechnung, die er gerade zeigt, an die Quelle, die in seinen eigenen Einstellungen für KoSIT steht, und der Bericht erscheint im Viewer in einem eigenen Reiter „KoSIT Validator“.

1. Neben der einzelnen Datei des Viewers: Legen Sie die Datei einvoice-validator-for-kosit-viewer.js aus dieser App neben einvoice-viewer-for-peppol-en16931-one-file.html, und tragen Sie ihren Namen oben in den Einstellungen dieser Datei ein, also addons: [ 'einvoice-validator-for-kosit-viewer.js' ],.
2. Im Ordner des Viewers: Entpacken Sie das ZIP dieser App in den Ordner der Viewer-App, sodass dort ein Ordner einvoice-validator-for-kosit liegt. Dann kommen auch die deutschen und französischen Texte des Knopfes mit.
3. Tragen Sie in config.js des Viewers unter sources.kosit dieselben Werte ein wie hier. Wie ausgeliefert ist es die Bridge auf demselben Rechner.

Der Viewer im Ordner lädt nichts aus dem Internet. Deshalb zeigt sein Bericht die Meldungen des Validators ohne die Erklärungen in Klartext; die volle Ansicht mit Erklärungen hat diese App.

5 · Einstellungen

Alle Einstellungen stehen in der Datei config.js im Ordner der App, bei der einzelnen Datei im Block ganz oben in der Datei.

6 · Was mit der Rechnung geschieht

• Die Rechnung geht als Datei an die Quelle unter sources.kosit.url. Sie prüft die Rechnung und vergisst sie danach.
• Den Bericht liest und erklärt die Seite im Browser.
• Die App sendet die Rechnung an keine andere Stelle. Die einzelne Datei lädt Sprachen und Regelkataloge von der Website unter site, sendet dorthin aber nichts aus der Rechnung.

7 · Wenn etwas nicht klappt