eInvoice Validator for VAMPIRE — VAMPIRE JS – Handbuch

1 · Überblick

VAMPIRE JS ist ein Zusatz zum eInvoice Validator for VAMPIRE. Ohne den Zusatz schickt die Seite des Validators jede Rechnung an Ihre Website, wo VAMPIRE PHP sie prüft. Mit dem Zusatz prüft die Seite die Rechnung im Browser des Besuchers mit VAMPIRE JS. Die Rechnung wird nicht an Ihre Website geschickt.

Was der Zusatz kann:

• Er prüft gegen dieselben Regelwerke wie VAMPIRE PHP: EN 16931 für UBL und CII, XRechnung, Peppol und die Profile von Factur-X und ZUGFeRD.
• Er zeigt denselben Bericht wie die Prüfung auf dem Server, mit denselben Erklärungen und derselben Ansicht der Rechnung.
• Er bietet report.xml zum Herunterladen an, im selben Format wie auf dem Server.
• Ist die Einstellung „Positiver Prüfbericht“ eingeschaltet, listet er auch jede Regel mit ihrem Ergebnis auf und bietet den JSON-Bericht und die Druckfassung an.

Was der Zusatz nicht kann:

• Er ändert den Knopf „Mit VAMPIRE prüfen“ im eInvoice Viewer nicht. Dieser Knopf prüft weiter auf dem Server.
• Er bietet kein „report.html herunterladen“ an. Diesen HTML-Bericht schreibt nur VAMPIRE PHP.
• Er wendet die Einstellungen „Gegen jede Fassung prüfen“ und „Regelprofile“ nicht an. Solange eine der beiden genutzt wird, prüft die Seite wie bisher auf dem Server, und die Einstellungsseite sagt das neben der Einstellung.
• Er zählt Prüfungen im Browser nicht gegen das tägliche Upload-Limit, weil sie Ihren Server nicht beanspruchen.

Voraussetzungen:

2 · Installieren

1. Laden Sie die ZIP-Datei unter Plugins → Installieren → Plugin hochladen hoch.
2. Aktivieren Sie das Plugin.
3. Öffnen Sie die Seite mit dem Validator und legen Sie dort eine Rechnung ab. Unter der Ablagefläche steht jetzt Die Rechnung wird in Ihrem Browser geprüft …, und die Zeile mit den verbleibenden Uploads des Tages erscheint nicht mehr.

Einstellungen

Der Zusatz hat keine eigene Einstellungsseite. Die Einstellungen des Validators unter eInvoice Validator → VAMPIRE gelten auch für die Prüfung im Browser, mit den zwei Ausnahmen aus dem Überblick.

3 · Arbeiten mit dem Zusatz

Die Seite sieht aus wie vorher, und Sie benutzen sie genauso: Sie legen eine PDF- oder XML-Datei ab, und darunter erscheint der Bericht. Eine ZUGFeRD- oder Factur-X-PDF wird wie bisher im Browser gelesen, und das eingebettete XML wird geprüft.

Ist in den Einstellungen des Validators „Positiver Prüfbericht“ eingeschaltet, nennt der Abschnitt „Geprüfte Regeln“ jede Regel mit ihrem Ergebnis, auch bei der Prüfung im Browser. Als Prüfprogramm steht dort VAMPIRE JS.

Eine grosse Rechnung braucht auf einem langsamen Computer einen Moment länger, weil jetzt der Computer des Besuchers die Arbeit macht. Die erste Prüfung auf einer Seite lädt ausserdem die Regelpakete, etwa 10 MB; jede weitere Prüfung auf derselben Seite benutzt sie wieder.

Schlägt die Prüfung im Browser fehl, sagt die Seite das in Rot. Sie schickt die Rechnung dann nicht stattdessen an den Server, denn dem Besucher wurde gesagt, dass die Rechnung auf seinem Computer bleibt.

4 · Datenschutz

Die Rechnung bleibt im Browser des Besuchers. Weder die Rechnung noch der Bericht werden an Ihre Website oder an einen anderen Dienst geschickt. Der Browser lädt die Regelpakete und den Feldkatalog von Ihrer Website, so wie er jede andere Datei der Seite lädt.

5 · Lizenz

Der Zusatz ist ein Kaufprodukt. Er enthält VAMPIRE JS und die Regelwerke ihrer Herausgeber. Die Datei assets/vampire/NOTICE nennt Herausgeber, Fassung und Lizenz jedes Regelwerks, und der Ordner assets/vampire/licences/ enthält die vollständigen Lizenztexte.

6 · Fassungen

7 · Bilderliste

Diese Liste zeigt, welche Bildschirmfotos dieses Handbuch erwartet und welche im Ordner screenshots/ des Pakets gefunden wurden. Ein Bild heißt immer Kennung.Sprache.png, zum Beispiel vj-einstellungen.de.png. Fehlt die deutsche Fassung, zeigt das Handbuch die englische. Auf den Bildern sind nur Beispieldaten zu sehen.