invoicePress / Handbücher / eInvoice Viewer — EPC QR Code

eInvoice Viewer — EPC QR Code – Handbuch

Gilt für Fassung 1.2.0, für das Plugin und für den Zusatz der Viewer-App. Stand 22.10.2026.

1 · Überblick

Der Zusatz „EPC QR Code“ ergänzt das WordPress-Plugin „eInvoice Viewer for PEPPOL & EN16931“ um den Reiter Überweisungscode. Der Reiter zeigt den EPC-QR-Code der Rechnung, den die deutschen Banken als GiroCode führen. Eine Banking-App liest daraus Empfänger, IBAN, Betrag und Verwendungszweck, und die Überweisung muss niemand abtippen.

Was der Zusatz kann:

Er bildet den Code aus den Zahlungsangaben der Rechnung, die der Viewer schon gelesen hat.
Er zeigt neben dem Code die Werte, die der Code enthält, damit Sie sie vor dem Absenden mit der Banking-App vergleichen.
Er lässt Sie wählen, wenn die Rechnung mehrere Bankverbindungen nennt.
Er sagt in einem Satz, warum eine Rechnung keinen Code bekommt.

Was der Zusatz nicht kann:

Er prüft nicht, ob die Bankverbindung zum Lieferanten gehört. Eine geänderte Bankverbindung ist das häufigste Muster des Rechnungsbetrugs; vergleichen Sie sie deshalb vor jeder Zahlung mit der, die Sie kennen. Die Seite sagt das über dem Code.
Er überweist nicht selbst und hat keinen Zugang zu einem Bankkonto.
Er erzeugt keinen Code für die Schweizer QR-Rechnung.

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 „EPC QR Code“ für die App

2 · Installieren

Laden Sie die ZIP-Datei unter Plugins → Installieren → Plugin hochladen hoch.
Aktivieren Sie das Plugin.
Öffnen Sie eine Seite mit dem Viewer und laden Sie eine Rechnung mit Bankverbindung. Neben „Rechnung“ und „XML“ steht jetzt der Reiter Überweisungscode.

Bildschirmfoto fehltscreenshots/eq-reiter.de.pngDie Werkzeugleiste des Viewers mit einer geladenen Rechnung; darunter steht der Reiter „Überweisungscode“ neben „RECHNUNG“ und „XML“

Die Werkzeugleiste des Viewers mit einer geladenen Rechnung; darunter steht der Reiter „Überweisungscode“ neben „RECHNUNG“ und „XML“

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.

Entpacken Sie die ZIP-Datei in den Ordner der App, also dorthin, wo ihre Startdatei liegt. Danach liegt dort die Datei einvoice-viewer-epc-qr.js neben der Startdatei, dazu das Handbuch und die deutschen und französischen Texte im Ordner addons/epc-qr/. Dieselbe Datei funktioniert auch neben der One-File-App des Viewers; dann genügt es, nur sie daneben zu legen. Ohne den Ordner holt sie die Texte der gewählten Sprache bei Bedarf von invoicePress.de.
Laden Sie die App im Browser neu und öffnen Sie eine Rechnung mit Bankverbindung. Neben „Rechnung“ und „XML“ steht jetzt der Reiter Überweisungscode.

Ab Fassung 2.38.0 des Viewers steht der Code im eigenen Reiter „Überweisungscode“, im Plugin wie in der App. Mit einem älteren Viewer zeigt ihn der Knopf Überweisungscode in der Werkzeugleiste in einem Bereich neben der Rechnung.

Einstellungen

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 · Arbeiten mit dem Zusatz

Der Reiter „Überweisungscode“ erscheint von selbst, sobald die Rechnung eine Bankverbindung nennt, und bleibt geschlossen, bis Sie ihn anklicken. Er zeigt den Hinweis zum Vergleich der Bankverbindung, den Code und die Werte, die er enthält. Nennt die Rechnung mehrere Bankverbindungen, wählen Sie das Konto im Feld Bankverbindung über dem Code. Eine neue Rechnung oder „Zurücksetzen“ entfernt den Reiter, damit nie der Code einer anderen Rechnung stehen bleibt. Mit button_speq="no" im Kurzbefehl des Viewers erscheint der Reiter auf dieser Seite nicht.

Bildschirmfoto fehltscreenshots/eq-code.de.pngDer Reiter „Überweisungscode“ mit dem Hinweis zur Bankverbindung, dem Feld „Bankverbindung“ mit zwei Konten, dem QR-Code und den Werten Empfänger, IBAN, BIC, Betrag und Verwendungszweck

Der Reiter „Überweisungscode“ mit dem Hinweis zur Bankverbindung, dem Feld „Bankverbindung“ mit zwei Konten, dem QR-Code und den Werten Empfänger, IBAN, BIC, Betrag und Verwendungszweck

Woher die Werte kommen

Wert	Feld der Rechnung
Empfänger	der Kontoinhaber ( BT-85 ), sonst der Zahlungsempfänger ( BT-59 ), sonst der Verkäufer ( BT-27 )
IBAN und BIC	die Bankverbindung ( BT-84 und BT-86 )
Betrag	der fällige Betrag ( BT-115 )
Verwendungszweck	der Verwendungszweck der Rechnung ( BT-83 ), sonst die Rechnungsnummer ( BT-1 )

Der Kontoinhaber steht vorn, weil Banken den Namen des Empfängers mit der IBAN abgleichen.

Wann es keinen Code gibt

Eine Rechnung ohne Bankverbindung oder eine, die per Lastschrift oder Karte bezahlt wird, bekommt keinen Reiter. In den übrigen Fällen sagt der Reiter, warum es keinen Code gibt.

Bildschirmfoto fehltscreenshots/eq-kein-code.de.pngDer Reiter bei einer Rechnung in einer anderen Währung als Euro: statt des Codes steht der Satz, warum es keinen gibt

Der Reiter bei einer Rechnung in einer anderen Währung als Euro: statt des Codes steht der Satz, warum es keinen gibt

Was die Seite sagt	Woran es liegt
Diese Rechnung nennt keine Bankverbindung für eine Überweisung.	Die Rechnung enthält keine IBAN.
Kein Überweisungscode: Diese Rechnung wird per Lastschrift oder Karte bezahlt.	Die Zahlungsart der Rechnung ist keine Überweisung; eine Überweisung zusätzlich würde doppelt zahlen.
Kein Überweisungscode: Den Code gibt es nur für Rechnungen in Euro.	Der EPC-QR-Code kennt nur Euro.
Kein Überweisungscode: Auf diese Rechnung ist nichts mehr zu zahlen.	Der fällige Betrag ist null, etwa nach einer Vorauszahlung.

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_transfer_code="no"]. Ohne Angabe bleibt alles an.

Schalter	Was auf der Seite fehlt
`tab_transfer_code`	der Reiter „Überweisungscode“
`button_speq`	derselbe Reiter, unter dem älteren Namen

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_transfer_code: false }. Nur der Wert false ohne Anführungszeichen schaltet ab.

4 · Datenschutz

Der Code entsteht im Browser aus der Rechnung, 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	Der Reiter „Überweisungscode“ erscheint von selbst, sobald die Rechnung eine Bankverbindung nennt; der Knopf entfällt. Das Feld zur Wahl der Bankverbindung sieht aus wie die übrigen Felder des Viewers.
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 eq-reiter.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
–	`eq-reiter.de.png`	Die Werkzeugleiste des Viewers mit einer geladenen Rechnung; darunter steht der Reiter „Überweisungscode“ neben „RECHNUNG“ und „XML“
–	`eq-code.de.png`	Der Reiter „Überweisungscode“ mit dem Hinweis zur Bankverbindung, dem Feld „Bankverbindung“ mit zwei Konten, dem QR-Code und den Werten Empfänger, IBAN, BIC, Betrag und Verwendungszweck
–	`eq-kein-code.de.png`	Der Reiter bei einer Rechnung in einer anderen Währung als Euro: statt des Codes steht der Satz, warum es keinen gibt