eInvoice Validator for VAMPIRE (app) – Manual

1 · Overview

The app eInvoice Validator for VAMPIRE is a page that runs in the browser without installation. You drop an e-invoice on the page, VAMPIRE JS checks it right in the browser, and the validation report appears below. For every finding the report names the field of the invoice and explains the rule in plain language.

The invoice does not leave your computer. There is no server, no service and no Java.

What the app does:

• It takes XML invoices and ZUGFeRD and Factur-X PDFs by drag and drop, by file selection or from the clipboard.
• It checks against the same rule sets as VAMPIRE PHP in the WordPress plugin: EN 16931, XRechnung, ZUGFeRD and Factur-X, and PEPPOL BIS Billing.
• It shows the report with verdict, findings, field names, explanations and the content of the invoice.
• It offers the report as report.xml for download.
• It speaks German, English and French.
• It comes as a folder and also as one single file.

Requirements:

2 · Setting up the app

As a folder

1. Unpack the ZIP file into a folder of your choice.
2. Open einvoice-validator-for-vampire.html with a double click, or put the folder on a web server.

The folder brings the fonts, the design and the rule catalogue along, and VAMPIRE JS in the folder vampire brings its rule sets. So the app loads nothing from a website.

As a single file

1. Take the file einvoice-validator-for-vampire-one-file.html and the file vampire-js.js from the folder, and put both into the same folder. The single file already names vampire-js.js in its settings.
2. Open the single file with a double click, or upload both files to your web server.

The single file carries English and the design Kit H. It loads further languages, the rule catalogues, the fonts and this manual from the website named under site in its settings; vampire-js.js loads the rule sets an invoice needs from there. Neither file sends anything from the invoice there.

In a website

The folder examples holds the page embed-one-file-iframe.html. It shows how the single file appears in a frame on a page of your website, without a scroll bar of its own and with the background of your page.

3 · Checking an invoice

1. Drag the invoice onto the drop area, or click it and choose the file.
2. Wait until "Checking …" disappears. The first check takes a little longer, because VAMPIRE JS then loads its rule sets.
3. Read the report. The verdict stands at the top, below it every finding with field and explanation, then the content of the invoice.
4. Click Download report.xml to keep the report.
5. Click Reset to empty the page.

Many invoices at once: the batch check

Above the drop area there are two tabs, Single check and Batch check. The batch check is for everyone who checks more than one invoice: the company that wants the incoming invoices of a month at a glance, and the small business that goes through its month folder once.

1. Choose the tab Batch check.
2. Drag invoices into the field. It takes single files, a whole folder with its subfolders, a ZIP file and an e-mail as .eml with attachments. Choose a folder picks a folder through the file dialog.
3. VAMPIRE JS checks the invoices one after the other in this browser. No invoice leaves the computer. The bar shows how many are checked; Cancel stops the batch, and the invoices checked so far stay in the overview.
4. The overview lists for each file the invoice number, the seller, the issue date, the amount, the verdict ( accepted, accepted with warnings, rejected, no e-invoice, not checked ), the number of errors and the most frequent rules. A click on a column head sorts, the buttons above filter by verdict, and the search field finds file names, invoice numbers, sellers and rules.
5. A click on a row shows the report of that invoice below the overview, with the explanation of every finding, exactly as in the single check.
6. Download overview ( CSV ) writes the overview as a table that Excel opens without an import dialog: semicolons between the columns and a decimal comma. A credit note carries a minus, so that the sum of a column is right. Summary report ( HTML ) writes a page to print or to file that loads nothing.

A PDF without an embedded invoice, such as a scanned invoice, appears as no e-invoice in the overview, so that it is clear it was not checked. A batch takes at most 500 files.

4 · Settings

All settings stand in the file config.js in the folder of the app; for the single file they stand in the block at the very top of the file.

5 · What happens to the invoice

• VAMPIRE JS checks the invoice in the browser. It is sent nowhere.
• The single file loads languages and rule catalogues from the website at site, but sends nothing from the invoice there.

6 · Troubleshooting