Schweizer QR-Rechnung mit Magento generieren

Chris / last updated on March 6, 2024

Mit meiner Advanced Invoice Layout Extension kann sehr einfach ein QR-Zahlschein nach den offiziellen Schweizer Vorgaben generiert und an die Magento PDF-Rechnung angehängt werden.

Aktivierung der QR-Rechnung in Magento

Für das Layout des Zahlscheins kommt eine Open Source Bibliothek zum Einsatz. Diese muss zunächst installiert werden, da diese nicht Teil der Standard Advanced Invoice Layout Installation ist:

composer require sprain/swiss-qr-bill

Als nächsten Schritt muss noch in der Konfiguration unter Stores › Configuration › vianetz Extensions › Advanced Invoice Layout › QR Bill Options das Feature aktiviert sowie die QR-IBAN und der Reference Type ausgewählt werden. Weitere Hilfestellungen finden sich auch in der FAQ der QR-Bibliothek.

Es kann außerdem noch konfiguriert werden, dass die QR-Rechnung nur für bestimmte Zahlungsarten aktiviert wird.

Anpassen des Layouts der QR-Rechnung

Das Layout sieht standardmäßig wie folgt aus: QR-Rechnung Beispiellayout

Um das Layout der QR-Rechnung individuell anzupassen, kann - wie für die Anpassung der Magento PDF-Rechnung auch einfach CSS-Code verwendet werden und in der Advanced Invoice Layout Konfiguration unter Stores › Configuration › vianetz Extensions › Advanced Invoice Layout › Custom CSS hinterlegt werden.
Der Selektor für die Tabelle im Zahlungsschein lautet #qr-bill.

Um den freien Platz auf der zusätzlichen PDF-Seite besser zu nutzen, kann außerdem auch der Platz oberhalb des Zahlscheins genutzt werden, um z.B. ein (Werbe-)Bild oder ähnliches anzuzeigen. Hierzu kann folgender CSS-Code genutzt werden:

#customQrBillContent { 
    background-image: url('https://www.vianetz.com/skin/frontend/default/vianetz/images/products/placeholder.png');
    background-repeat: none;
    width: 700px;
    height: 500px;
}

« Back to the FAQ overview