eInvoice Validator for VAMPIRE (App) – Handbuch

1 · Überblick

Die App eInvoice Validator for VAMPIRE ist eine Seite, die ohne Installation im Browser läuft. Sie legen eine E-Rechnung auf die Seite, VAMPIRE JS prüft sie gleich im Browser, 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 Rechnung verlässt Ihren Rechner nicht. Es gibt keinen Server, keinen Dienst und kein Java.

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 prüft gegen dieselben Regelwerke wie VAMPIRE PHP im WordPress-Plugin: EN 16931, XRechnung, ZUGFeRD und Factur-X sowie PEPPOL BIS Billing.
• Sie zeigt den Bericht mit Urteil, Befunden, Feldnamen, Erklärungen und dem Inhalt der Rechnung.
• Sie bietet den 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.

Voraussetzungen:

2 · Die App aufstellen

Als Ordner

1. Entpacken Sie die ZIP-Datei in einen Ordner Ihrer Wahl.
2. Öffnen Sie einvoice-validator-for-vampire.html mit einem Doppelklick, oder legen Sie den Ordner auf einen Webserver.

Der Ordner bringt die Schriften, die Gestaltung und den Regelkatalog mit, und VAMPIRE JS im Ordner vampire bringt seine Regelwerke mit. So lädt die App nichts von einer Website.

Als einzelne Datei

1. Nehmen Sie die Datei einvoice-validator-for-vampire-one-file.html und die Datei vampire-js.js aus dem Ordner, und legen Sie beide in denselben Ordner. Die einzelne Datei nennt vampire-js.js schon in ihren Einstellungen.
2. Öffnen Sie die einzelne Datei mit einem Doppelklick, oder laden Sie beide Dateien 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; vampire-js.js lädt von dort die Regelwerke, die eine Rechnung braucht. Aus der Rechnung sendet keine der beiden Dateien etwas dorthin.

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 · 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. Die erste Prüfung dauert etwas länger, weil VAMPIRE JS dann seine Regelwerke lädt.
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 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. VAMPIRE JS prüft die Rechnungen nacheinander in diesem Browser. Keine Rechnung verlässt den Rechner. 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.

4 · Einstellungen

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

5 · Was mit der Rechnung geschieht

• VAMPIRE JS prüft die Rechnung im Browser. Sie wird an keine Stelle gesendet.
• Die einzelne Datei lädt Sprachen und Regelkataloge von der Website unter site, sendet dorthin aber nichts aus der Rechnung.

6 · Wenn etwas nicht klappt