eInvoice Validation Explorer for VAMPIRE

Kaufprodukt · WordPress-Plugin und App · Version 1.1.0 · Erklärt die Prüfberichte von VAMPIRE PHP und VAMPIRE JS

Den VAMPIRE-Prüfbericht verstehen: jede Meldung mit Feld, Wert und Stelle in der Rechnung

Der eInvoice Validation Explorer for VAMPIRE macht aus einem Prüfbericht von VAMPIRE eine Erklärung, die Sie verstehen. Sie legen den Bericht ab, beim JSON-Bericht zusammen mit der geprüften E-Rechnung. Dann sagt Ihnen der Explorer zu jedem Befund, welches Feld der Rechnung gemeint ist, welcher Wert dort steht und wo die Stelle in der Rechnung liegt.

VAMPIRE prüft E-Rechnungen nach den offiziellen Prüfregeln, ohne Java. Der Explorer prüft nicht selbst, sondern erklärt, was VAMPIRE festgestellt hat. Im Plugin geschieht das auf Ihrer eigenen Website, in der App direkt in Ihrem Browser. Zusammen mit dem kostenlosen eInvoice Viewer steht jeder Befund sogar direkt unter seinem Feld in der lesbaren Rechnung.

Im Shop erwerben

Handbuch lesen

App und Plugin

Der Validation Explorer for VAMPIRE als App und als WordPress-Plugin

Den Explorer gibt es als App: ein Ordner, den Sie entpacken und per Doppelklick öffnen, auf Ihrem Rechner, im Intranet oder in SharePoint. Die App braucht keinen Server und keine Prüf-Engine, denn sie liest einen Bericht, der schon vorliegt. Der Bericht und die Rechnung verlassen Ihren Rechner nicht. Sie liest den JSON-Bericht mit der Rechnung oder den XML-Bericht von VAMPIRE PHP und VAMPIRE JS.

Das WordPress-Plugin ist derselbe Explorer mit den Zusatzfunktionen einer Website: Sie begrenzen die Aufrufe je Besucher und Tag, legen fest, ab welcher Rolle er erscheint, und zeigen die Befunde direkt an den Feldern des eInvoice Viewers. Das Plugin setzt das kostenlose Viewer-Plugin voraus. App und Plugin sind Kaufprodukte und tragen dieselbe Versionsnummer.

VAMPIRE hat geprüft, aber der Bericht ist für Fachleute geschrieben

VAMPIRE prüft E-Rechnungen in den Formaten XRechnung, ZUGFeRD, Factur-X und Peppol BIS. VAMPIRE PHP läuft auf Ihrem Webserver, VAMPIRE JS in JavaScript, auf einem Server mit Node.js oder direkt im Browser. Als Ergebnis bekommen Sie einen Prüfbericht mit Regelkennungen, Meldungen und Pfaden durch eine XML-Datei.

Welches Feld der Rechnung gemeint ist und welcher Wert dort steht, sagt Ihnen dieser Bericht nicht in Ihren Worten. Der JSON-Bericht enthält die Rechnung nicht einmal, er nennt nur die Fundstellen. Dabei wollen Sie am Ende nur dem Lieferanten, dem Kunden oder der Kollegin in einem Satz sagen können, was an der Rechnung zu ändern ist.

Bericht ablegen, Erklärung lesen

Der Explorer liest beide Berichtsformen von VAMPIRE. Er ordnet jeden Befund dem passenden Feld der EN 16931 zu, der europäischen Norm, die festlegt, welche Angaben eine E-Rechnung enthält. Er zeigt den Wert, der tatsächlich in der Rechnung steht, und markiert die Stelle in einer Ansicht der Rechnung, der Belegansicht.

1 · Prüfbericht ablegen
Sie legen den Bericht von VAMPIRE PHP oder VAMPIRE JS ab, als JSON-Datei oder als XML-Datei im Format des KoSIT-Validators.
2 · Beim JSON-Bericht die Rechnung dazulegen
Der JSON-Bericht braucht die geprüfte Rechnung als XML-Datei in CII oder UBL. Der XML-Bericht bringt sie selbst mit, dann genügt diese eine Datei.
3 · Erklärung lesen
Sie lesen zu jedem Befund Klartext, Feld und Wert und springen mit einem Klick an die Stelle in der Rechnung.

So entsteht die Erklärung: Sie legen den Bericht ab, beim JSON-Bericht mit der Rechnung, und lesen zu jedem Befund Feld, Wert und Stelle.

1. Viewer und Plugin installieren

Das Plugin setzt den kostenlosen eInvoice Viewer for PEPPOL & EN16931 voraus. Sie installieren zuerst den Viewer, laden dann die ZIP-Datei aus dem Shop in WordPress hoch und aktivieren das Plugin. Die Regel- und Feldkataloge liegen bei, einstellen müssen Sie für den Start nichts.

2. Shortcode einsetzen

Sie fügen [spxv_validation_report] in eine Seite ein. Ein Shortcode ist ein kurzer Platzhalter in eckigen Klammern, an dessen Stelle WordPress das Werkzeug anzeigt.

3. Bericht ablegen

Die Seite hat zwei beschriftete Felder, oben für den Bericht und unten für die Rechnung. Ein XML-Bericht wird sofort erklärt. Beim JSON-Bericht wartet die Seite auf die Rechnung und sagt Ihnen, was noch fehlt.

Was den Validation Explorer for VAMPIRE besonders macht

Beide Berichtsformen von VAMPIRE

Der Explorer liest den JSON-Bericht zusammen mit der geprüften Rechnung und den XML-Bericht im Format des KoSIT-Validators, der die Rechnung schon enthält. Beim XML-Bericht bleibt eine zusätzlich übergebene Rechnung unbeachtet, damit immer der Beleg erscheint, den VAMPIRE wirklich gesehen hat.

Was Sie davon haben: Sie nehmen den Bericht, den Ihre Software ohnehin schreibt, und müssen nichts umwandeln.

Das betroffene Feld und sein tatsächlicher Wert

Jeder Befund wird seinem Fachbegriff der EN 16931 zugeordnet, mit der BT- oder BG-Nummer. Business Terms (BT) und Business Groups (BG) sind die nummerierten Felder und Feldgruppen der Norm. Betrifft ein Befund eine Anlage der Rechnung, nennt der Explorer ihren Namen, etwa „Anlage: Aufmass.pdf“.

Was Sie davon haben: Sie sehen sofort, welche Angabe der Lieferant ändern muss, und können ihm den falschen Wert nennen.

Was ein roher VAMPIRE-Bericht zeigt und was der Validation Explorer hinzufügt
	Roher VAMPIRE-Bericht	Mit dem Validation Explorer
Ergebnis, Regelkennung und Meldung	✓	✓
Erklärung in Klartext	–	✓
Betroffenes Feld mit BT- oder BG-Nummer	–	✓
Wert, der in der Rechnung steht	–	✓
Sprung zur Stelle in der Rechnung	–	✓
Befund direkt unter seinem Feld in der lesbaren Rechnung	–	✓

Die ganze Kette ohne Java

VAMPIRE prüft ohne Java, und auch der Explorer braucht es nicht: Das Plugin läuft mit WordPress und PHP, die App in einem aktuellen Browser. Mit VAMPIRE JS und der App des Explorers bleiben Prüfung und Erklärung sogar vollständig im Browser.

Was Sie davon haben: Sie können Prüfung und Erklärung auf gewöhnlichem Webhosting oder ganz ohne Server betreiben.

Keine Meldung geht verloren

Manche Meldungen zeigen auf keine Stelle in der Rechnung, zum Beispiel weil sie das Schema betreffen. Sie stehen im Kasten „Nicht zugeordnet“ am Ende, jede mit Regelkennung, Begründung und dem Pfad aus dem Bericht.

Was Sie davon haben: Sie sehen den vollständigen Bericht und können sich darauf verlassen, dass die Seite dasselbe sagt wie VAMPIRE, nur verständlicher.

Suchen, filtern und in drei Sprachen lesen

Ein Suchfeld durchsucht die Belegansicht nach Feldname, Wert oder BT-Nummer. Der Schalter „BT-Nummern“ blendet die Nummern ein und aus, der Schalter „nur Befunde“ zeigt nur die Zeilen mit Fehlern und Warnungen. Die Oberfläche gibt es auf Deutsch, Englisch und Französisch; deutsche Regeltexte gibt es für XRechnung.

Was Sie davon haben: Auch in einer Rechnung mit Hunderten Zeilen finden Sie mit wenigen Tastenanschlägen die Angabe, die Sie suchen.

Im eInvoice Viewer: prüfen und den Befund am Feld sehen

Der kostenlose eInvoice Viewer for PEPPOL & EN16931 ist das zentrale Werkzeug für Ihre E-Rechnungen. Er zeigt jede Rechnung lesbar an. Ist auf Ihrer Website der kostenlose eInvoice Validator for VAMPIRE installiert, steht in seiner Werkzeugleiste der Knopf „Mit VAMPIRE prüfen“, und der Bericht öffnet sich in einem eigenen Reiter „VAMPIRE Validator“.

Mit dem Validation Explorer for VAMPIRE stehen die Erklärungen genau in diesem Reiter. Ein Klick auf „Position“ an einer Meldung öffnet den Reiter „RECHNUNG“ am betroffenen Feld, und dort steht jeder Befund direkt unter seinem Feld. Auch auf der eigenen Seite des Explorers zeigt die Ansicht „Beleg“ die Rechnung mit jedem Befund an seinem Feld, sobald der Viewer aktiv ist.

Nach unserer Kenntnis ist der Validation Explorer das einzige Werkzeug, das die Meldungen eines fertigen Prüfberichts am betroffenen Feld der lesbaren Rechnung zeigt. Eine Recherche vom 13. Oktober 2026 über rund 35 Werkzeuge hat kein anderes gefunden.

Was Sie davon haben: Lesen, prüfen und verstehen geschieht auf einer Seite, und Sie sehen einen Fehler dort, wo er in der Rechnung steht.

Zum eInvoice Viewer

Für wen der Explorer gedacht ist

Die Buchhaltung
Eine Eingangsrechnung fällt bei VAMPIRE durch. Die Buchhalterin legt den Bericht ab, liest, welches Feld betroffen ist, und schreibt dem Lieferanten eine Rückfrage, die er auch versteht.
Die Entwicklerin
Ihre Software prüft jede ausgehende Rechnung mit VAMPIRE PHP und speichert den JSON-Bericht. Meldet VAMPIRE einen Fehler, legt sie Bericht und Rechnung ab und sieht das Feld der Norm und den Wert, den ihre Software geschrieben hat.
Der Dienstleister
Eine Kanzlei oder Agentur prüft Rechnungen für ihre Kunden mit VAMPIRE. Statt den rohen Bericht weiterzureichen, verweist sie auf eine Seite ihrer Website, auf der sich der Kunde den Bericht selbst erklären lässt.
Der Betreiber ohne Java
Auf seinem Webhosting läuft kein Java. Mit VAMPIRE und dem Explorer prüft er E-Rechnungen und erklärt die Ergebnisse trotzdem vollständig.

Der Shortcode

[spxv_validation_report]

Mit dem Attribut bt legen Sie für eine einzelne Seite fest, ob die BT-Nummern beim Öffnen sichtbar sind, zum Beispiel [spxv_validation_report bt="0"] für die Buchhaltung.

Die Einstellungen

Die Einstellungen stehen im eigenen Menüpunkt eInvoice Validation Explorer → VAMPIRE im Adminbereich von WordPress. Findet das Plugin seine Regeldaten nicht, warnt dort ein gelber Hinweis.

Die Einstellungen des Plugins und ihre Voreinstellungen
Einstellung	Voreinstellung	Wozu sie dient
Tägliche Uploads je Rolle	10 je Rolle	Eine Zeile für Gäste und eine für jede Rolle: leer heißt unbegrenzt, 0 heißt kein Zugang. Administratoren sind nie begrenzt.
Maximale Dateigröße (MB)	8	Gilt je Datei. Die Upload-Grenze Ihres Servers gilt zusätzlich.
Proxy-Header vertrauen	aus	Für Websites hinter einem Reverse Proxy, dem Sie vertrauen.
BT-Nummern standardmäßig anzeigen	an	Besucher können die Nummern im Bericht selbst umschalten.
Design-Kit	Kit H	Bestimmt die Gestaltung und gilt für alle eInvoice-Werkzeuge der Website.

Für Entwickler

Die REST-Adresse POST /wp-json/einvoice/v1/explain-vampire nimmt die Dateifelder report und invoice entgegen und liefert die fertige Ansicht zurück. Die Einzelheiten beschreibt das Handbuch.

Bericht und Rechnung bleiben bei Ihnen

Im Plugin nur auf Ihrer eigenen Website
Bericht und Rechnung gehen an Ihre WordPress-Installation und nur dorthin. Das Plugin stellt keine Anfrage an einen anderen Server und lädt keine Schriften von außen.
Nichts wird aufbewahrt
Die Dateien werden aus dem vorübergehenden Upload im Arbeitsspeicher gelesen. Sie landen nicht im Upload-Verzeichnis und in keinem Protokoll.
In der App bleibt alles im Browser
In der Voreinstellung löst die App keinen einzigen Abruf aus. Bericht und Rechnung werden im Browser gelesen und nirgendwohin gesendet.
Die Tagesgrenze ohne gespeicherte IP-Adresse
Angemeldete Benutzer zählt das Plugin nach ihrem Konto, Gäste nach einem Hashwert ihrer IP-Adresse. Der Zähler verfällt nach einem Tag.

Bitte beachten Sie: Bericht und Rechnung enthalten in der Regel Namen, Anschriften, Bankverbindungen und Beträge. Wenn Sie das Plugin öffentlich anbieten, liegen diese Daten während der Anfrage im Arbeitsspeicher Ihres Servers. Erwähnen Sie das in Ihrer Datenschutzerklärung.

Was der Explorer bewusst nicht tut

Er prüft nicht selbst. Das Ergebnis stammt von VAMPIRE; der Explorer gibt es wieder und erklärt es.
Zum JSON-Bericht braucht er die Rechnung. Ohne sie liest er den Bericht zwar vollständig, aber die Belegansicht bleibt leer.
Er nimmt nur JSON- und XML-Dateien an. Ein PDF, auch ein ZUGFeRD-PDF, lässt sich nicht ablegen.
Er ist für Berichte von VAMPIRE gebaut. Für den KoSIT-Validator und für Mustang gibt es eigene Explorer.
Er berichtigt und speichert nichts. Er schreibt keine Rechnung, und es gibt kein Archiv früherer Berichte.
Deutsche Regeltexte gibt es für XRechnung. Bei den übrigen Regelwerken steht der englische Originaltext, und die Ansicht weist darauf hin.

Passt dazu

eInvoice Validator for VAMPIRE

Prüft E-Rechnungen direkt in WordPress mit VAMPIRE PHP, ohne Java, und zeigt den Bericht in derselben Klartext-Ansicht. Mehr erfahren
kostenlos

eInvoice Validation Explorer for KoSIT und for Mustang

Die Schwesterwerkzeuge für die Berichte des offiziellen KoSIT-Validators und des Mustang-Validators. Als Plugins laufen alle drei nebeneinander. for KoSIT · for Mustang
Kaufprodukte

eInvoice Viewer – Extended Profiles

Erklärt auch die Regeln von ZUGFeRD / Factur-X EXTENDED und EXTENDED-CTC-FR und zeigt die Werte der Erweiterungsfelder. Mehr erfahren
Kaufprodukt

Regelwerke erklärt der mitgelieferte Katalog

8 604

Regeln mit Erklärung, von EN 16931 bis Peppol BIS

311

Felder der EN 16931 kennt der Feldkatalog

Anfragen an fremde Dienste

Zum Katalog gehören EN 16931 in CII und UBL, XRechnung, Peppol BIS Billing 3, Factur-X EN16931, die französischen Flux-2-Regeln und die Länderanpassungen für Portugal, Rumänien, Kroatien, Belgien und Italien. Drei weitere Regelwerke mit 3 190 Regeln, Factur-X EXTENDED und EXTENDED-CTC-FR, erklärt der Explorer mit dem Zusatz „Extended Profiles“.

Häufige Fragen

Prüft der Explorer meine Rechnungen?

Nein. Er erklärt einen Prüfbericht, den VAMPIRE PHP oder VAMPIRE JS bereits geschrieben hat. Wenn Sie die Prüfung selbst in WordPress ausführen möchten, nehmen Sie das kostenlose Plugin „eInvoice Validator for VAMPIRE“.

Reicht der Bericht allein, oder brauche ich auch die Rechnung?

Das hängt von der Form ab. Der XML-Bericht von VAMPIRE trägt die Rechnung in sich und genügt allein. Der JSON-Bericht nennt nur die Fundstellen; dazu legen Sie die geprüfte Rechnung als XML-Datei ab.

Der Explorer for KoSIT liest doch auch VAMPIRE-Berichte. Wozu dieser?

Der Explorer for KoSIT liest die XML-Berichte von VAMPIRE, weil sie das Format des KoSIT-Validators haben. Den JSON-Bericht von VAMPIRE PHP und VAMPIRE JS liest nur der Explorer for VAMPIRE.

Was brauche ich, um das Plugin zu nutzen?

WordPress ab 6.0, PHP ab 7.4 und den kostenlosen eInvoice Viewer for PEPPOL & EN16931, denn WordPress aktiviert den Explorer nur, solange der Viewer aktiv ist. Java brauchen Sie weder für VAMPIRE noch für den Explorer.

Gibt es den Explorer auch ohne WordPress?

Ja. Plugin und App sind ein Produkt mit derselben Versionsnummer. Die App ist ein Ordner, dessen Startdatei Sie per Doppelklick im Browser öffnen, auf Ihrem Rechner, einem Netzlaufwerk oder Ihrem Webserver. Dort ziehen Sie Bericht und Rechnung gemeinsam auf eine Fläche, und die App erkennt am Inhalt, was der Bericht ist.

Werden Bericht und Rechnung gespeichert?

Nein. Im Plugin werden sie nur während der Anfrage im Arbeitsspeicher Ihres Servers verarbeitet, in der App nur im Browser. An invoicePress oder einen fremden Dienst geht nichts.

Was sehe ich bei einer Rechnung im Profil ZUGFeRD EXTENDED?

Ohne den Zusatz „Extended Profiles“ zeigt ein Befund zu einer Regel der Erweiterung die Kennung und die Meldung des Validators, und ein Hinweis sagt, was der Zusatz ergänzen würde. Mit dem Zusatz werden diese Regeln erklärt, und die Felder der Erweiterung erscheinen.

Machen Sie aus dem nächsten VAMPIRE-Bericht eine Erklärung, die jeder versteht. Erwerben Sie den Validation Explorer for VAMPIRE im Shop von invoicePress.de, setzen Sie den Shortcode auf Ihre Seite oder öffnen Sie die App, und sehen Sie zu jedem Befund Feld, Wert und Stelle.

Im Shop erwerben

Handbuch lesen

Zum eInvoice Viewer