eInvoice Viewer — Hybrid Check – Handbuch
1 · Überblick
Eine ZUGFeRD- oder Factur-X-Rechnung trägt zwei Rechnungen in einer Datei: das PDF, das ein Mensch liest, und die Rechnungsdaten im XML, die die Buchhaltung verarbeitet. Nichts im Format zwingt beide, dasselbe zu sagen. Genau dort setzt Rechnungsbetrug an: Im XML steht eine andere IBAN, und das Sichtbild zeigt weiter die vertraute Bankverbindung.
Der Zusatz „Hybrid Check“ ergänzt das WordPress-Plugin „eInvoice Viewer for PEPPOL & EN16931“ um diesen Vergleich. Sobald der Viewer eine Rechnung mit Sichtbild gelesen hat, vergleicht er von selbst Rechnungsnummer, Endbetrag und Bankverbindung des Sichtbilds mit den Rechnungsdaten.
Was der Zusatz kann:
- Er vergleicht das PDF einer ZUGFeRD- oder Factur-X-Rechnung mit ihren Rechnungsdaten.
- Er vergleicht auch ein PDF, das in einer XRechnung als Anhang steckt, wenn es die Rechnungsnummer zeigt.
- Er zeigt das Ergebnis im Reiter „Hybrid Check“ und markiert einen Widerspruch am betroffenen Feld der Rechnung.
Was der Zusatz nicht kann:
- Er liest kein gescanntes PDF. Ein Sichtbild ohne lesbaren Text wird nicht verglichen; der Zusatz sagt das.
- Er meldet nicht, dass etwas im Sichtbild fehlt. Viele Vorlagen drucken die Bankverbindung nicht oder nur als Grafik; gemeldet wird nur ein Widerspruch.
- Er vergleicht keine Anhänge, die nicht die Rechnung selbst zeigen, etwa ein Aufmaß oder einen Mietvertrag.
Voraussetzungen:
| Voraussetzung | Angabe |
|---|---|
| WordPress | 5.8 oder neuer |
| PHP | 8.2 oder neuer |
| Plugin | eInvoice Viewer for PEPPOL & EN16931 |
| In der Viewer-App | statt WordPress und Plugin: die Viewer-App ab Fassung 2.37.1 und der Zusatz „Hybrid Check“ für die App |
2 · Installieren
In der Viewer-App
Für die Viewer-App gibt es den Zusatz als eigene ZIP-Datei im Shop. Er arbeitet dort ganz im Browser, ohne WordPress und ohne Server.
Ab Fassung 2.38.0 des Viewers steht das Ergebnis in einem eigenen Reiter, im Plugin wie in der App; mit einem älteren Viewer steht es in einem Bereich neben der Rechnung. Der Reiter öffnet sich nicht von selbst, damit die Rechnung im Blick bleibt; einen Widerspruch kündigt ein Satz über der Rechnung an. Mit tab_sphc="no" im Kurzbefehl des Viewers läuft die Prüfung auf dieser Seite nicht.
screenshots/hc-hinweis.de.pngDer gelbe Satz über der Rechnung, der einen Widerspruch zwischen Sichtbild und Rechnungsdaten ankündigtEinstellungen
Der Zusatz hat keine eigene Einstellungsseite. Auf der Einstellungsseite des Viewers legen Sie unter „Verfügbar ab Rolle“ fest, wer die Zusätze sieht.
3 · Was der Vergleich meldet
| Was die Seite sagt | Bedeutung |
|---|---|
| Das Sichtbild zeigt Rechnungsnummer und Endbetrag der Rechnungsdaten. | Beide Seiten stimmen überein. Steht auch die Bankverbindung im Sichtbild, nennt der Satz sie mit. |
| Die Rechnungsnummer, der Endbetrag oder die Bankverbindung der Rechnungsdaten steht nicht im Sichtbild. | Ein Widerspruch. Er steht zusätzlich als Karte am Feld der Rechnung. Vergleichen Sie beide Seiten, bevor Sie zahlen. |
| Das Sichtbild enthält keinen lesbaren Text. | Das PDF ist vermutlich ein Scan. Es wurde nicht verglichen. |
Eine Rechnung ohne PDF, also eine reine XML-Datei ohne Anhang, bekommt keinen Abschnitt, weil es nichts zu vergleichen gibt.
screenshots/hc-uebereinstimmung.de.pngDer Reiter „Hybrid Check“ mit einem grünen Befund: Rechnungsnummer und Endbetrag stehen im Sichtbildscreenshots/hc-widerspruch.de.pngDer Reiter „Hybrid Check“ mit einer Warnung: Der Endbetrag der Rechnungsdaten steht nicht im Sichtbildscreenshots/hc-feld.de.pngDie Summentabelle der Rechnung mit der Meldung des Hybrid Check in einer eigenen Zeile unter „Gesamtbetrag mit Umsatzsteuer“ (BT-112)Auf einer Seite ausschalten
Im Kurzbefehl des Viewers schalten Sie auf einer einzelnen Seite ab, was dieser Zusatz zeigt, zum Beispiel [spev_einvoice_viewer tab_hybrid_check="no"]. Ohne Angabe bleibt alles an.
| Schalter | Was auf der Seite fehlt |
|---|---|
tab_hybrid_check | der Reiter „Hybrid Check“ |
tab_sphc | die Prüfung selbst; sie läuft auf dieser Seite nicht |
Ein Schalter nimmt etwas nur von dieser Seite. Wer den Zusatz überhaupt benutzen darf, legt „Verfügbar ab Rolle“ in den Einstellungen des Viewers fest. In der Viewer-App gelten dieselben Namen in config.js, etwa features: { tab_hybrid_check: false }. Nur der Wert false ohne Anführungszeichen schaltet ab.
4 · Datenschutz
Der Vergleich läuft im Browser. Das PDF ist die Datei, die der Viewer schon gelesen hat. Der Zusatz sendet nichts an Ihre Website und an keinen fremden Dienst, und er speichert nichts.
5 · Lizenz
Der Zusatz steht unter der Lizenz GPL-2.0-or-later.
6 · Fassungen
| Fassung | Was sich geändert hat |
|---|---|
| 1.2.0 | Die Meldungen im Reiter „Hybrid Check“ sind Karten wie beim Inbound Check: oben das Feld und „Fehler“, „Warnung“ oder „OK“, darunter der Satz. |
| 1.0.0 | Erste Fassung. |
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 hc-hinweis.de.png. Fehlt die deutsche Fassung, zeigt das Handbuch die englische. Auf den Bildern sind nur Beispieldaten zu sehen.
| Stand | Datei | Was zu sehen ist |
|---|---|---|
| – | hc-hinweis.de.png | Der gelbe Satz über der Rechnung, der einen Widerspruch zwischen Sichtbild und Rechnungsdaten ankündigt |
| – | hc-uebereinstimmung.de.png | Der Reiter „Hybrid Check“ mit einem grünen Befund: Rechnungsnummer und Endbetrag stehen im Sichtbild |
| – | hc-widerspruch.de.png | Der Reiter „Hybrid Check“ mit einer Warnung: Der Endbetrag der Rechnungsdaten steht nicht im Sichtbild |
| – | hc-feld.de.png | Die Summentabelle der Rechnung mit der Meldung des Hybrid Check in einer eigenen Zeile unter „Gesamtbetrag mit Umsatzsteuer“ (BT-112) |