M0053 QR-Zahlcode für Gambio
Handbuch
1. Was das Modul kann
Das Modul zeigt bzw. druckt einen QR-Code, mit dem Ihre Kundschaft eine Rechnung besonders bequem bezahlen kann: einfach mit der Banking-App scannen – Empfänger, IBAN, Betrag und Verwendungszweck sind bereits ausgefüllt. Das erspart das fehleranfällige Abtippen, beschleunigt den Zahlungseingang und macht eingehende Zahlungen dank eindeutigem Verwendungszweck leicht zuordenbar.
Es werden zwei Standards unterstützt, und das Modul wählt für jede Bestellung automatisch den passenden aus – abhängig vom Rechnungsland:
- GiroCode (SEPA) für Zahlungen in Euro – gelesen von den gängigen deutschen und europäischen Banking-Apps.
- Schweizer QR-Rechnung (Swiss QR Code mit Schweizer Kreuz) für Rechnungen in die Schweiz und nach Liechtenstein – als vollständiger Zahlteil mit Empfangsschein, wie ihn Schweizer Banking-Apps erwarten.
Alle angezeigten Codes entstehen direkt in Ihrem Shop. Es werden keine Kontodaten oder Beträge an einen externen Dienst übertragen.
2. Wo Sie das Modul im Backend finden
Sie finden das Modul im Administrationsbereich unter Module → Ihre Xycons-Module. Öffnen Sie dort den Eintrag QR-Zahlcode. Sämtliche Einstellungen nehmen Sie auf der Setup-Seite dieses Moduls vor.
3. Einrichtung (Setup)
Richten Sie das Modul zuerst vollständig ein, bevor Sie es verwenden. Die folgenden Abschnitte erklären jede Einstellung. Zu jeder Einstellung finden Sie auf der Setup-Seite selbst außerdem den gewohnten Xycons-Hilfetext direkt am Feld.
Die Setup-Seite ist recht lang; die folgenden Abbildungen zeigen sie in Ausschnitten von oben nach unten.
3.1 Grundeinstellungen
| Einstellung | Bedeutung | Standard |
|---|---|---|
| Modulstatus - QR-Zahlcode | Schaltet das Modul insgesamt ein oder aus. Ist es ausgeschaltet, erscheint an keiner Stelle ein QR-Code. | Ausgeschaltet |
| Ihre Lizenz: | Reine Anzeige, welcher Lizenztyp erkannt wurde. | – |
| Landesauswahl | Zweistellige Ländercodes, kommagetrennt, für die der GiroCode angeboten werden soll. Leer lassen, um den GiroCode für alle Länder anzubieten. (Für die Schweiz gilt zusätzlich Abschnitt 3.6.) | leer (alle Länder) |
| Nutze Rechnungs-Nummer | Ersetzt im Verwendungszweck die Bestellnummer durch die Rechnungsnummer, sobald diese erzeugt wurde. | Nein |
| Zahlinfos zum QR-Code | Zeigt die im Code enthaltenen Zahlungsdaten zusätzlich als lesbaren Text neben bzw. unter dem QR-Code an (nicht im Kopfbereich der Rechnung). | Nein |
3.2 Unterstützte Zahlungsweisen
Legen Sie fest, für welche Zahlungsweisen überhaupt ein QR-Code erzeugt wird. So bieten Sie den Code gezielt nur dort an, wo eine Überweisung sinnvoll ist (etwa Vorkasse oder Rechnung).
| Einstellung | Zahlungsweise |
|---|---|
| Vorkasse unterstützen | Vorkasse / Überweisung |
| Rechnung unterstützen | Kauf auf Rechnung |
| EU-Überweisung unterstützen | EU-Standardüberweisung |
| HUB-Rechnung unterstützen | Rechnung über den Gambio-HUB |
| HUB-Vorkasse unterstützen | Vorkasse über den Gambio-HUB |
| HUB-Barzahlung unterstützen | Barzahlung über den Gambio-HUB |
| Barzahlung unterstützen | Barzahlung |
Die Wahl der Zahlungsweisen gilt für den GiroCode. Die Schweizer QR-Rechnung wird unabhängig davon anhand des Rechnungslandes erzeugt (siehe Abschnitt 3.6).
3.3 Bankverbindung (Empfängerkonto)
Hier hinterlegen Sie das Konto, auf das Ihre Kundschaft zahlt. Diese Angaben werden in den GiroCode geschrieben.
| Einstellung | Bedeutung |
|---|---|
| Kontoinhaber (Name) | Name des begünstigten Kontoinhabers (Ihr Konto). |
| Konto-IBAN | IBAN des begünstigten Kontos. |
| Konto-BIC | BIC des begünstigten Kontos. |
Für die Schweizer QR-Rechnung wird ein eigenes Schweizer Empfängerkonto benötigt; dieses hinterlegen Sie separat in Abschnitt 3.6.
3.4 Wo der QR-Code erscheint
Für jede Anzeigestelle können Sie einzeln entscheiden, ob der Code erscheint, wie groß er ist und welcher erläuternde Content-Inhalt darüber steht. Die Größe geben Sie in Pixeln an.
Bestellabschluss-Seite
| QR im Checkout? | Zeigt den Code auf der Bestellabschluss-Seite nach dem Kauf. |
| QR-Größe Bestellabschluss | Anzeigegröße in Pixeln (Standard 200px). |
| Content Bestellabschluss | Optionale Content-Nummer, deren Inhalt oberhalb des Codes erscheint. Der Content wird im Bereich „Element“ unter „Sonstige“ angelegt. |
Bestellbestätigungs-Mail (zur Einbindung in die Mailvorlage siehe Kapitel 5)
| QR in der Bestellbestätigungsmail? | Erzeugt den Code für die Bestellbestätigungs-Mail. |
| QR-Größe in der Bestellbestätigungsmail | Anzeigegröße in Pixeln (Standard 200px). |
| Content Bestellbestätigungsmail | Optionale Content-Nummer oberhalb des Codes. |
Rechnung
| QR auf der Rechnung? | Druckt den Code auf die Rechnung. |
| QR-Größe auf der Rechnung | Anzeigegröße in Pixeln (Standard 100px). Für die Position im Kopfbereich sollten 100px genommen werden, damit die Ausrichtung passt. |
| Hinweistext auf Rechnung | Druckt den unter der Textphrase hinterlegten Hinweistext vor dem Code. |
| QR Position | Ob der Code im Kopfbereich oder nach den Rechnungshinweisen erscheint. Gilt nur für den GiroCode – die Schweizer QR-Rechnung steht immer auf einer eigenen letzten Seite (siehe Kapitel 6). |
| Vertikale Verschiebung | Feinjustierung der Position nach oben/unten (nur Kopfbereich, GiroCode). |
| Horizontale Verschiebung | Feinjustierung der Position nach links/rechts (nur Kopfbereich, GiroCode). |
3.5 Offene Rechnungen im Kundenkonto
Im Kundenkonto kann das Modul für offene Rechnungen QR-Codes anbieten – entweder einen gemeinsamen Code für alle offenen Posten (nur GiroCode) oder je einen Code pro einzelner offener Rechnung.
| QR für alle Offenen | Bietet im Kundenkonto einen gemeinsamen Sammel-Code für alle offenen Rechnungen an. |
| QR-Größe alle Offenen | Anzeigegröße in Pixeln (Standard 200px). |
| Content alle Offenen | Optionale Content-Nummer oberhalb des Codes. |
| QR für einzeln Offene | Bietet je offener Rechnung einen eigenen Code an. |
| QR-Größe einzeln Offene | Anzeigegröße in Pixeln (Standard 200px). |
| Content einzeln Offene | Optionale Content-Nummer oberhalb des Codes. |
| Offener Bestellstatus (-1- bis -5-) | Welche Bestellstatus als „zur Zahlung offen“ gelten. Sie können bis zu fünf Status auswählen; nur Bestellungen in diesen Status werden im Kundenkonto zur Zahlung angeboten. |
Der Shop zeigt im Kundenkonto standardmäßig nur die letzten 5 Bestellungen. Damit ältere offene Rechnungen sichtbar bleiben (und für den Sammel-Code berücksichtigt werden), erhöhen Sie diese Anzahl im Shop auf einen Wert wie 10 oder 20.
Für die Schweiz gibt es keinen gemeinsamen Sammel-Code: Der Schweizer Standard erlaubt keine Bündelung mehrerer Rechnungen in einem Code, da jede QR-Rechnung ihre eigene Referenz trägt. Schweizer Kundschaft erhält daher je offener Rechnung einen eigenen Code.
3.6 Schweizer QR-Rechnung
Damit Kundschaft in der Schweiz und in Liechtenstein per QR-Code zahlen kann, erzeugt das Modul die Schweizer QR-Rechnung. Aktivieren und hinterlegen Sie dazu:
| Einstellung | Bedeutung | Standard |
|---|---|---|
| Schweizer QR-Rechnung | Aktiviert die Schweizer QR-Rechnung für die unten gewählten Länder. | Nein |
| Länder für QR-Rechnung | Rechnungsländer (kommagetrennt), die eine Schweizer QR-Rechnung auslösen. | CH,LI |
| Währung QR-Rechnung | Ausschließlich CHF oder EUR. Wird verwendet, wenn die Bestellwährung keine davon ist. | CHF |
| Referenztyp | Art der Zahlungsreferenz: QRR (QR-Referenz, benötigt QR-IBAN), SCOR (Creditor Reference) oder NON (ohne Referenz). Erläuterung in Kapitel 6. | NON |
| QRR-Kundenidentifikation | Nur bei QRR: Ihre von der Bank vergebene Kundenidentifikation, aus der die QR-Referenz gebildet wird. | leer |
| QR-IBAN / IBAN (CH/LI) | Ihre Schweizer oder Liechtensteiner IBAN. Für den Referenztyp QRR ist eine QR-IBAN erforderlich. | leer |
| Empfänger – Name | Name des Zahlungsempfängers (Ihr Unternehmen). | leer |
| Empfänger – Strasse | Straße ohne Hausnummer. | leer |
| Empfänger – Hausnummer | Hausnummer. | leer |
| Empfänger – PLZ | Postleitzahl. | leer |
| Empfänger – Ort | Ort. | leer |
| Empfänger – Land | Zweistelliger Ländercode des Empfängers. | CH |
Voraussetzung: Für die Schweizer QR-Rechnung ist ein Empfängerkonto mit Schweizer oder Liechtensteiner IBAN (Länderkennung CH oder LI) zwingend erforderlich. Eine deutsche IBAN wird vom Schweizer Standard nicht akzeptiert.
4. Der Verwendungszweck im QR-Code
Der Verwendungszweck, den der Code ausfüllt, ist frei gestaltbar. Sie passen ihn über die Shopfunktion „Texte ändern“ an (Textphrase des Moduls). Beachten Sie die maximale Länge von 140 Zeichen.
Voreingestellt ist der Verwendungszweck so aufgebaut:
@@ORDERID@@ v. @@ORDERDATE@@ - KD @@CUSTNO@@ - RG: @@INVOICENO@@ v. @@INVOICEDATE@@
Das ergibt beispielhaft: 4711 v. 01.02.2026 - KD 442233 - RG: 2026-22012 v. 02.02.2026. Folgende Platzhalter stehen zur Verfügung:
| Platzhalter | Inhalt |
|---|---|
| @@ORDERID@@ | Bestell-Nummer |
| @@ORDERDATE@@ | Bestell-Datum |
| @@CUSTNO@@ | Kunden-Nummer |
| @@INVOICENO@@ | Rechnungs-Nummer |
| @@INVOICEDATE@@ | Rechnungs-Datum |
5. QR-Code in der Bestellbestätigungs-Mail
Damit der Code auch in der Bestellbestätigungs-Mail erscheint, fügen Sie an der gewünschten Stelle der Mailvorlage einen kleinen Platzhalter-Block ein (zusätzlich zur Einstellung aus Abschnitt 3.4).
Öffnen Sie im Administrationsbereich Kunden → E-Mails → E-Mail-Vorlagen, rufen Sie die Vorlage Bestellbestätigung zur Änderung auf und fügen Sie im Quellcode an der gewünschten Stelle ein:
<br style="clear: right;" />
{if $GIROCODE != ''}<br />
<span style="font-size:12px; font-family: verdana,geneva,sans-serif;">
{$GIROHEADER}<br />{$GIROCONTENT}<br />{$GIROCODE}<br />
</span>
{/if}
Speichern Sie die Vorlage. Leeren Sie anschließend im Bereich Toolbox → Cache zuerst den Cache für die E-Mail-Vorlagen und danach den Cache für die Seitenausgabe.
Der Code in der Mail wird als Bild aus Ihrem eigenen Shop geladen. Ein externer Dienst ist dafür nicht nötig.
6. Die Schweizer QR-Rechnung verstehen
Die Schweizer QR-Rechnung ist ein eigener Standard und unterscheidet sich grundlegend vom GiroCode. Sie erscheint als vollständiger Zahlteil mit Empfangsschein und wird standardgerecht auf einer eigenen, letzten Seite der Rechnung ausgegeben – damit der Beleg sauber abgetrennt werden kann. Die Positionswahl aus Abschnitt 3.4 (Kopfbereich / nach Rechnungshinweis) betrifft daher nur den GiroCode.
Mit oder ohne Referenz?
Die Referenz ordnet eine eingehende Zahlung eindeutig Ihrer Rechnung zu. Wählen Sie passend zu Ihrem Schweizer Konto:
- Ohne Referenz (NON) – der einfachste Fall, passend zu einer normalen Schweizer IBAN. Empfohlen, wenn Sie unsicher sind.
- Creditor Reference (SCOR) – eine strukturierte Referenz nach ISO 11649 zu einer normalen IBAN.
- QR-Referenz (QRR) – die klassische Schweizer Zahlungsreferenz. Sie setzt zwingend eine QR-IBAN voraus (eine besondere IBAN, die Sie von Ihrer Bank gesondert erhalten) sowie Ihre QRR-Kundenidentifikation.
Merksatz: Normale Schweizer IBAN → NON (oder SCOR). QRR nur, wenn Ihnen Ihre Bank ausdrücklich eine QR-IBAN bereitgestellt hat. Passen Referenztyp und IBAN-Art nicht zusammen, wird sicherheitshalber kein Code erzeugt.
Wenn einmal kein Code erscheint
Damit niemals ein ungültiger Zahlcode ausgegeben wird, prüft das Modul die Daten vorab und lässt den Code im Zweifel weg. Häufige Gründe:
- Empfänger-IBAN, Name, PLZ oder Ort sind noch nicht vollständig hinterlegt.
- Es wurde QRR gewählt, aber keine echte QR-IBAN hinterlegt.
- Für den GiroCode: die Zahlungsweise ist nicht freigegeben oder das Rechnungsland nicht in der Landesauswahl enthalten.
7. Modultexte ändern
Modultexte können Sie – wie bei allen Modulen von uns – über die Shopfunktion „Texte ändern“ im Administrationsbereich an eigene Bedürfnisse anpassen, etwa den Hinweistext auf der Rechnung, die Überschriften über den Codes oder den Verwendungszweck (Kapitel 4).
8. Shopupdate und Modulpflege
Vor einem Shopupdate (Servicepack oder Masterupdate) prüfen Sie bitte auf der Xycons-Seite, ob das Modul für die neue Shopversion freigegeben ist.
Installieren Sie beim Shopupdate immer die neuesten Versionen des Moduls und der Modulumgebung – nicht nur den Shop aktualisieren. Ein altes Modul passt sich nicht von selbst an eine neue Shopversion an. Wenn wir Ihr Shopupdate durchführen, aktualisieren wir vorhandene Xycons-Module und die Modulumgebung mit, sofern sie für die Shop-Masterversion verfügbar sind.
9. Häufige Fragen
Muss ich für die Schweiz etwas umschalten?
Nein. Sobald das Rechnungsland Schweiz oder Liechtenstein ist, erzeugt das Modul automatisch die Schweizer QR-Rechnung, sonst den GiroCode.
Kann ich für die Schweiz meine deutsche IBAN verwenden?
Nein. Der Schweizer Standard lässt ausschließlich Schweizer oder Liechtensteiner IBANs zu. Ohne ein solches Konto ist keine Schweizer QR-Rechnung möglich.
Brauche ich eine spezielle QR-IBAN?
Nur, wenn Sie mit der QR-Referenz (QRR) arbeiten. Für NON und SCOR genügt eine normale Schweizer IBAN.
Warum sieht der Code auf dem Bildschirm größer aus als die eingestellte Pixelzahl?
Auf der Rechnung (PDF) wird die Größe in Punkten umgesetzt; ein PDF-Betrachter zeigt bei 100% etwas größer an als die reine Pixelzahl. Im Ausdruck stimmt die physische Größe.
Kann ein Schweizer Kunde den deutschen GiroCode scannen?
In der Regel nicht – Schweizer Banking-Apps sind auf die Schweizer QR-Rechnung ausgelegt. Deshalb erzeugt das Modul für die Schweiz automatisch das passende Format.
Warum sehen manche Kunden im Kundenkonto keine älteren offenen Rechnungen?
Erhöhen Sie im Shop die Anzahl der im Kundenkonto angezeigten Bestellungen (z. B. auf 10 oder 20), siehe Abschnitt 3.5.
