eInvoice Viewer – WordPress-Plugin

Kostenlos · WordPress-Plugin

Der eInvoice Viewer als WordPress-Plugin. Ein Shortcode genügt.

Mit dem kostenlosen Plugin lesen Ihre Besucher E-Rechnungen direkt auf Ihrer WordPress-Website, als übersichtlichen Beleg mit allen Feldern, Bankkonten und Anlagen. Eine E-Rechnung ist eine Rechnung als strukturierte Datei, die ein Programm lesen kann, ein Mensch aber kaum.

Sie installieren das Plugin aus dem Verzeichnis von WordPress.org und setzen einen Shortcode auf eine Seite. Ein Shortcode ist ein kurzer Platzhalter in eckigen Klammern, an dessen Stelle WordPress den Viewer zeigt. Die Rechnung wird im Browser des Besuchers gelesen. Zum Ansehen erreicht sie Ihren Server nie. Nur wenn Sie einen Validator anschließen und der Besucher einen Prüfknopf drückt, geht sie an die Prüf-Engine, die Sie selbst eingestellt haben.

Die Zentrale auf Ihrer Website. Das Plugin ist der Viewer plus Steuerung: Sie legen fest, wer ihn wie oft benutzen darf und ab welcher Rolle jeder Zusatz erscheint. Prüfknöpfe für den offiziellen KoSIT-Validator, Mustang und VAMPIRE, der Hybrid Check, der Überweisungscode und alle anderen Zusätze erscheinen als Reiter in derselben Ansicht.

Kostenlos auf WordPress.org herunterladen

Demo ausprobieren

In drei Schritten

Installieren, Shortcode setzen, fertig.

Installieren

Öffnen Sie im WordPress-Backend, dem Verwaltungsbereich Ihrer Website, den Menüpunkt „Plugins“. Suchen Sie dort nach „eInvoice Viewer“, installieren Sie das Plugin und aktivieren Sie es.

Shortcode setzen

Setzen Sie den Shortcode [spev_einvoice_viewer] auf eine beliebige Seite. Mit bt="1" sind die BT-Nummern von Anfang an sichtbar; BT steht für Business Term, also für die nummerierten Felder der Norm EN 16931. Einzelne Knöpfe und die Reiter XML und PDF schalten Sie je Seite ab, zum Beispiel mit tab_spev_pdf="no".

Einstellen

Unter „eInvoice Viewer → Viewer“ legen Sie die größte erlaubte Dateigröße, die Anzeige der BT-Nummern und das Design-Kit fest. Im Abschnitt „Zugang und Grenzen“ bestimmen Sie, wie viele Rechnungen Gäste und jede Rolle am Tag öffnen dürfen und ab welcher Rolle jeder Zusatz erscheint.

Aktuelle Version: 2.39.0. Voraussetzungen: WordPress 5.8 oder neuer (getestet bis 7.1) und PHP 8.2 oder neuer. Lizenz: GPL 2.0 oder später. Was der Viewer zeigt und liest, steht ausführlich auf der Übersichtsseite des Viewers. Ohne WordPress gibt es denselben Viewer kostenlos als App.

Neu in den Versionen 2.36 bis 2.38

Was das Plugin jetzt zusätzlich für Sie tut.

Reiter für Rechnung, XML, PDF und jeden Zusatz
Seit 2.38 stehen unter der Werkzeugleiste die Reiter RECHNUNG, XML und PDF. Der Reiter XML zeigt die Rechnung so wie die Validatoren, mit Suche und BT-Nummern; der Reiter PDF zeigt auch eine PDF, die in eine XML-Rechnung eingebettet ist. Jeder Zusatz mit einem Ergebnis bekommt einen eigenen Reiter. Für Sie heißt das: Alles zu einer Rechnung liegt auf einer Seite, und nichts öffnet sich in einem fremden Fenster.
Prüfknöpfe für drei Validatoren
Ist der eInvoice Validator for KoSIT, for Mustang oder for VAMPIRE installiert, bekommt die Werkzeugleiste je einen eigenen Prüfknopf. Der Bericht erscheint im Reiter „KoSIT Validator“, „Mustang Validator“ oder „VAMPIRE Validator“, mit report.xml und, bei KoSIT und VAMPIRE, report.html zum Herunterladen. Seit 2.38.1 prüft auch der KoSIT-Knopf eine ZUGFeRD- oder Factur-X-PDF. Mit einem Validation Explorer steht jeder Befund außerdem direkt an seinem Feld.
Knöpfe je Seite abschalten
Seit 2.38.0 nehmen Sie jeden Knopf und die Reiter XML und PDF mit einer Angabe im Shortcode von einer Seite, etwa button_spev_rulebrowser="no". Seit 2.39.0 gilt das auch für die Reiter der Zusätze und für Zusätze ohne eigenen Knopf, etwa die Markierungen des Identifier Check. So zeigen Sie auf einer öffentlichen Seite nur das Nötige und auf einer internen Seite alles.
Zugang und Grenzen je Rolle
Sie legen eine tägliche Zahl an Rechnungen für Gäste und für jede Rolle fest und für jeden Zusatz die Rolle, ab der er erscheint. Darunter verhält sich der Viewer, als wäre der Zusatz nicht installiert. Vor jeder Rechnung fragt der Viewer nur kurz nach, ob noch Zugang besteht, und sendet dabei keine Rechnungsdaten.
Einstellungsdialog auf der Website
Seit 2.36.0 öffnet der Knopf „Einstellungen“ einen Dialog, sobald ein Zusatz eigene Einstellungen mitbringt, zum Beispiel der Inbound Check für Unternehmensdaten und Lieferantenliste. Die Werte liegen in der Datenbank Ihrer Website, jedes Speichern erzeugt eine neue Revision, und eine Sicherungsdatei nimmt alles mit.
Design-Kits für alle Werkzeuge
Kit H ist die Vorgabe, Kit A ist schlichter, Kit S zeigt den Viewer in den Farben der specialPress-Websites, und seit 2.37.0 laden Sie auch ein eigenes Kit hoch. Die Wahl gilt für alle eInvoice-Werkzeuge Ihrer Website, und die Schriften liegen im Plugin.

Für Entwickler

Ein Shortcode, und darunter eine klare Schnittstelle.

Einbinden

Ein Shortcode genügt. Setzen Sie [spev_einvoice_viewer] auf eine beliebige Seite. Mit dem Attribut bt="1" sind die Business-Term-Kennungen von Anfang an sichtbar, mit bt="0" sind sie zunächst verborgen, und mit lite="1" beginnt die Ansicht mit nur den gefüllten Feldern. Der Besucher kann beides jederzeit selbst umschalten.

Das Wissen über die EN 16931, die europäische Norm für die Angaben in einer E-Rechnung, liegt in einem eigenen JavaScript-Kern, der im Browser läuft. Es gibt keine PDF-Bibliothek zum Schreiben, keine Template-Engine und kein Framework. Für Sie heißt das: wenig Code, den Sie warten und prüfen müssen.

Der Viewer ist ein Web Component mit dem Namen <einvoice-viewer>, also ein eigenes HTML-Element, das in jeder Seite verwendet werden kann. Es ist dasselbe Element im Shortcode, in der eigenständigen App und in einem fremden CMS. Das gelesene Rechnungsmodell steht unter viewer.model bereit, dazu rawXml, syntax, file und identifiers. Die Ereignisse einvoice-model-ready, einvoice-language-changed und einvoice-reset steigen bis zum Dokument auf.

1 · Datei ablegen
im Browser des Besuchers

2 · Der JavaScript-Kern liest
das Modell steht unter viewer.model bereit

3 · Die Ansicht erscheint
mit allen installierten Zusätzen

So arbeitet der Viewer: Die Datei wird im Browser gelesen, das Modell steht für Ihren Code bereit, und die Ansicht erscheint mit allen Zusätzen.

Erweiterungspunkte

viewer.extendModel und viewer.extendTooltip hängen Abschnitte an das Modell an und ergänzen Zeilen in einem BT- oder BG-Tooltip.
Die Schnittstelle trägt die Nummer 4. Neu sind addBadge() für eine zweite kleine Plakette neben der Feldnummer, addSettingsSection(), getSettings() und openSettings() für den Einstellungsdialog. Mit requireViewerApi() prüft ein Zusatz, ob die nötige Schnittstelle da ist.
spev_force_enqueue lädt Skripte und Stile auch ohne Shortcode, spev_register_settings fügt den Abschnitt eines Zusatzes in die Einstellungsseite ein, und einvoice_design_kit setzt das Design-Kit aller eInvoice-Werkzeuge im Code.
Über REST-Routen liest, schreibt, sichert und lädt der Einstellungsdialog seine Werte. Ein Schreibversuch auf einem veralteten Stand wird mit dem Status 409 abgewiesen, damit niemand die Änderung eines anderen überschreibt.

Arbeitet mit den Zusätzen zusammen

Ein Zusatz, auch Add-on genannt, ist ein weiteres Plugin, das den Viewer um eine Fähigkeit erweitert. Sie installieren den Zusatz, und seine Funktion erscheint in derselben Ansicht, meist mit einem eigenen Reiter. Die Datei wird dafür kein zweites Mal eingelesen, und zum Anfangen ist meist nichts einzustellen. Nur der Inbound Check braucht zuerst Ihre Unternehmensdaten und Ihre Lieferantenliste. Diese Bausteine gibt es:

eInvoice Viewer
kostenlos · zeigt jede E-Rechnung als Beleg

+ Technical Details
Kaufzusatz · Kardinalität (wie oft ein Feld vorkommen darf), Datentyp und XPath, also die Fundstelle im XML, dazu ein Feld-, ein Regel- und ein Referenz-Browser

+ Extended Profiles
Kaufzusatz · zeigt die Erweiterungen ZUGFeRD/Factur-X EXTENDED und EXTENDED-CTC-FR

+ Visualizer
Kaufzusatz · fünf Drucklayouts und ein PDF/A-3 zum Herunterladen

+ Exporter
Kaufzusatz · übernimmt die Rechnung in eine Excel-Tabelle, in der jedes Feld der EN 16931 seinen Platz hat

+ Identifier Check
Kaufzusatz · prüft USt-IdNr., LEI, IBAN und nationale Unternehmensnummern

+ Inbound Check
Kaufzusatz · stellt die Plausibilitätsfragen der Kreditorenbuchhaltung, etwa ob die Rechnung an Ihren Betrieb gerichtet ist

+ Hybrid Check
Kaufzusatz · vergleicht das PDF mit den Rechnungsdaten, etwa die IBAN

+ EPC QR Code
Kaufzusatz · zeigt den Reiter „Überweisungscode“ für die Banking-App

+ eInvoice Validator for KoSIT, Mustang, VAMPIRE
kostenlos · je ein Prüfknopf mit Bericht im eigenen Reiter

+ eInvoice Validation Explorer for KoSIT, Mustang, VAMPIRE
Kaufprodukt · zeigt den Prüfbericht in Klartext und jeden Befund an seinem Feld

Der kostenlose Viewer und die Bausteine, die ihn erweitern: Kostenloses ist blau markiert, Kaufzusätze sind orange markiert.

Alle Werkzeuge mit Beschreibung und Link finden Sie auf der Übersichtsseite im Abschnitt Ein Viewer, viele Werkzeuge. Der KoSIT-Validator ist das offizielle Prüfprogramm der KoSIT, der Koordinierungsstelle für IT-Standards, für XRechnungen. Der eInvoice Validator for KoSIT verbindet ihn mit Ihrer Website, er bringt ihn aber nicht selbst mit.

Holen Sie den Viewer auf Ihre WordPress-Website.

Kostenlos, ohne Konto und ohne fremden Dienst. Installieren Sie das Plugin direkt aus WordPress.org und setzen Sie Ihren ersten Shortcode. Wie das im Einzelnen geht, zeigt das Handbuch.

Kostenlos auf WordPress.org herunterladen