Was sind QR-Codes?

QR-Codes (Quick Response Codes) sind zweidimensionale Barcodes, die Informationen wie URLs, Kontaktdaten oder Texte speichern können. In Output.Rocks können Sie dynamische QR-Codes erstellen, die sich automatisch an Ihre Kundendaten anpassen und nahtlos in Ihre Dokumente integrieren lassen.

QR-Codes in Output.Rocks werden ähnlich wie Bilder über Bildmarken in Ihre .docx-Vorlagen eingefügt. Der Unterschied: Statt statische Bilder zu referenzieren, generiert das System die QR-Codes dynamisch basierend auf Ihren Konfigurationen und Daten.

Mit dem QR-Code-Editor können Sie verschiedene Aspekte Ihrer QR-Codes anpassen - von der visuellen Gestaltung bis hin zu technischen Parametern wie der Fehlerkorrektur.

Die generierten QR-Codes können interaktive Elemente enthalten, die Ihre Kunden direkt zu relevanten Informationen, Zahlungsportalen oder Kontaktformularen führen. Verwenden Sie dafür Payload-Platzhalter wie <<payload.customer.contract_id>>, um Inhalte aus ihrem System zu integrieren, zbsp. um Links zu Kundenportalen dynamisch zu generieren.

Die ersten Schritte

1. QR-Code-Konfiguration im Editor
2. Integration in Ihre Vorlagen
3. Dynamische QR-Codes mit Kundendaten
4. EPC-Banking-QR-Codes für SEPA-Überweisungen
5. Schweizer QR-Rechnung

1. QR-Code-Konfiguration im Editor

Der QR-Code-Editor

Der QR-Code-Editor ist Ihr zentrales Werkzeug für die Erstellung und Verwaltung von QR-Codes. Hier können Sie sowohl den Inhalt als auch die visuelle Erscheinung Ihrer QR-Codes definieren und eine Live-Vorschau generieren.

Grundkonfiguration

Der erste Schritt ist die Definition des QR-Code-Inhalts und der technischen Parameter:

https://kundenportal.stadtwerke-beispiel.de/rechnung/<<contract.id>>

Fehlerkorrekturstufen verstehen

Farbgestaltung

QR-Codes können an Ihr Corporate Design angepasst werden. Die wichtigsten Gestaltungsoptionen:

Logo-Integration

Für eine stärkere Markenidentität können Sie zentrale Logos hinzufügen, die in der Mitte des QR-Codes platziert werden und dessen Lesbarkeit nicht beeinträchtigen.

2. Integration in Ihre Vorlagen

Schritt 1: QR-Codes als Bildmarken einsetzen

QR-Codes werden in Output.Rocks genau wie normale Bilder über das Bildmarken-System in Ihre .docx-Vorlagen integriert. Der Prozess funktioniert in zwei Schritten: Zuerst erstellen und konfigurieren Sie den QR-Code im Backend, dann fügen Sie ein Platzhalter-Bild mit der entsprechenden Bildmarke img_identifierDesQrCodes am Platzhalter in Ihr Word-Dokument ein.

Beim Rendern wird das Platzhalter-Bild automatisch durch den generierten QR-Code ersetzt und orientiert sich an dessen Maßen.

Schritt 2: Vorlagen-Zuweisung im Backend

Die Zuweisung von QR-Codes zu Vorlagen ist essentiell für das korrekte Funktionieren. Sie haben zwei Möglichkeiten, diese Verbindung herzustellen:

Die erste Methode eignet sich besonders, wenn Sie eine spezifische Vorlage bearbeiten und wissen möchten, welche QR-Codes verfügbar sind. Die zweite Methode ist effizienter, wenn Sie einen QR-Code erstellt haben und diesen für mehrere Vorlagen gleichzeitig aktivieren möchten. Beide Zuweisungsoptionen sind auch im Vorlagen-Editor verfügbar, sodass Sie QR-Codes direkt während der Bearbeitung zuweisen können.

Bildmarken-Präfixe für korrekte Skalierung

Wie bei normalen Bildern können Sie verschiedene Skalierungsoptionen verwenden:

3. Dynamische QR-Codes mit Logik und Kundendaten

Ein besonderer Mehrwert von QR-Codes entsteht durch die Integration von kunden- oder systemspezifischen Parametern. Typische Anwendungsfälle sind etwa die Integration

• von Kundennummern, die direkt zu Rechnungen, Zählerständen oder Vertragsverwaltung führen.
• von Systemparametern, die direkt zu immer aktuellen Service-Funktionen führen.
• von berechneten oder logischen Werten, um z.Bsp. relevante Angebote oder Kampagnen auswählen

Kundenspezifische URLs und Inhalte

https://kundenportal.stadtwerke-beispiel.de/rechnung/<<contract.id>>?token=<<customer.loginToken>>

https://ablesung.stadtwerke-beispiel.de/erfassen?kunde=<<customer.id>>&zaehler=<<meter.serialNumber>>

https://services.stadtwerke-beispiel.de/vertrag/<<contract.id>>/verwalten

Dynamische QR-Code-Parameter

Auch die QR-Code-Konfiguration selbst kann dynamisch angepasst werden:

<<$qrIdentifier = map(customer.tariff, 'premium', 'qr_premium_portal', 'qr_standard_portal')>>

Fehlerbehandlung und Best Practices

Ideen für erweiterte Anwendungsfälle:

• Notfall-Hotlines: QR-Codes mit Telefonnummern für sofortige Hilfe bei Störungen
• Kundenfeedback: Direkte Weiterleitung zu Bewertungsportalen oder Umfragen
• Smart Meter Integration: Links zu Apps für Verbrauchsmonitoring und Energieanalysen

4. EPC-Banking-QR-Codes für SEPA-Überweisungen

EPC-QR-Codes (European Payments Council) sind ein standardisiertes Format für Banking-QR-Codes, die direkte SEPA-Überweisungen ermöglichen. Diese speziellen QR-Codes werden von Banking-Apps in Deutschland, Österreich, Belgien, Finnland und den Niederlanden automatisch erkannt und ermöglichen es Kunden, Rechnungen mit einem einzigen Scan zu bezahlen.

Solche EPC-QR-Codes können auch mit Output.Rocks QR-Code-Editor erstellt werden, solange sie der BCD-Struktur folgen.

Offizielle technische EPC-Spezifikationen:

EPC-QR-Code-Struktur verstehen

EPC-QR-Codes nutzen eine zeilenbasierte Datenstruktur (jede Zeile ist ein Datenfeld) mit fest definierten Feldern:

Beispiel: EPC-QR-Code für Stromrechnungen

BCD
001
1
SCT
STWBDE33XXX
Stadtwerke Beispiel GmbH
DE89370400440532013000
EUR<<invoice.totalAmount>>

<<contract.contractNumber>>

Erweiterte EPC-QR-Code-Varianten:

BCD
001
1
SCT
STWBDE33XXX
Stadtwerke Beispiel GmbH
DE89370400440532013000
EUR<<invoice.totalAmount>>
ELEC
<<contract.contractNumber>>
Stromrechnung <<invoice.period>>

5. Schweizer QR-Rechnung

Die Schweizer QR-Rechnung ist ein nationaler Schweizer Standard für Rechnungen und Einzahlungsscheine. Der kodierte String, das Layout mit Zahlteil und Empfangsschein sowie die Verarbeitungsregeln folgen den Swiss Payment Standards der SIX bzw. der auf paymentstandards.ch gebündelten Dokumentation.

Offizielle Spezifikation und weiterführende Informationen

• QR-Rechnung – Swiss Payment Standards (SIX, deutsch) – Überblick, gültige Versionen der Implementation Guidelines und Verweise auf Downloads (u. a. Swiss Implementation Guidelines for the QR-bill, Style Guide, Verarbeitungsregeln).
• QR-Rechnung – Swiss Payment Standards (SIX, englisch) – gleiche Inhalte auf Englisch.
• paymentstandards.ch – Einstieg in die Schweizer Zahlungsstandards inkl. Download-Center für die genannten Dokumente.
• qr-rechnung.ch – öffentlichkeitsorientierte Einführung zur QR-Rechnung in der Schweiz (SIX).
• Swiss Implementation Guidelines for the QR-bill, Version 2.4 (PDF, deutsch) – verbindliche Fachspezifikation inkl. Datenstruktur für den QR-String und Zahlteil; Grundlage für die Standard-Payload-Struktur unter QRCH.

Downloadbare Teil‑Vorlage für den Zahlteil-Footer

Der Zahlteil der Schweizer QR-Rechnung wird als modularer Baustein in der Fußzeile der .docx‑Stammvorlage eingebunden: technisch handelt es sich dabei um eine Teil‑Vorlage, die Sie mit <<refLookup:template.chQRinvoiceFooter>> an genau dieser Stelle einfügen und die beim Rendern mit der Stammvorlage zusammengeführt wird.

Die Fußzeile nur für die erste Seite sollte für diesen Zahlteil links, rechts und unten keinerlei zusätzlichen Rand aufweisen. Die genaue Umsetzung ist weiter unten beschrieben.

Downloadbare Vorlage zum Einbinden und Anpassen:

QR-Code-Element im Backend

Sowohl Reihenfolge wie auch Art der zeilenweise Ausgabe der kodierten Zahldaten im QR-Code müssen dem Swiss Payment Standards folgen. Auch die Konfiguration der Darstellung des QR-Codes, wie Fehlerkorrekturstufe, Farben und Größen, müssen diesen Standards entsprechen. Hier sehen sie, welche Eingaben sie dringend befolgen sollten.

<<QRCH.Header.Version>>
<<QRCH.Header.Coding>>
<<QRCH.CdtrInf.IBAN>>
<<QRCH.CdtrInf.Cdtr.AdrTp>>
<<QRCH.CdtrInf.Cdtr.Name>>
<<QRCH.CdtrInf.Cdtr.StrtNmOrAdrLine1>>
<<QRCH.CdtrInf.Cdtr.BldgNbOrAdrLine2>>
<<QRCH.CdtrInf.Cdtr.PstCd>>
<<QRCH.CdtrInf.Cdtr.TwnNm>>
<<QRCH.CdtrInf.Cdtr.Ctry>>
<<QRCH.UltmtCdtr.AdrTp>>
<<QRCH.UltmtCdtr.Name>>
<<QRCH.UltmtCdtr.StrtNmOrAdrLine1>>
<<QRCH.UltmtCdtr.BldgNbOrAdrLine2>>
<<QRCH.UltmtCdtr.PstCd>>
<<QRCH.UltmtCdtr.TwnNm>>
<<QRCH.UltmtCdtr.Ctry>>
<<QRCH.CcyAmt.Amt>>
<<QRCH.CcyAmt.Ccy>>
<<QRCH.UltmtDbtr.AdrTp>>
<<QRCH.UltmtDbtr.Name>>
<<QRCH.UltmtDbtr.StrtNmOrAdrLine1>>
<<QRCH.UltmtDbtr.BldgNbOrAdrLine2>>
<<QRCH.UltmtDbtr.PstCd>>
<<QRCH.UltmtDbtr.TwnNm>>
<<QRCH.UltmtDbtr.Ctry>>
<<QRCH.RmtInf.Tp>>
<<QRCH.RmtInf.Ref>>
<<QRCH.RmtInf.AddInf.Ustrd>>
<<QRCH.RmtInf.AddInf.Trailer>>
<<QRCH.RmtInf.AddInf.StrdBkgInf>>
<<QRCH.AltPmtInf.AltPmt[0]>>
<<QRCH.AltPmtInf.AltPmt[1]>>

Datenobjekt QRCH im Payload

Zur Laufzeit erwartet die Teil‑Vorlage chQRinvoiceFooter die Felder unter dem Payload‑Objekt QRCH. Struktur und Inhalte richten sich nach der Swiss QR-Rechnung in der zum Lieferzeitpunkt gültigen Fassung der Implementation Guidelines; für die Ausrichtung an der aktuellen Norm dient die verlinkte Version 2.4 der Implementation Guidelines (PDF, deutsch).

{
  "QRCH": {
    "specReference": "Schweizer Implementation Guidelines QR-Rechnung, Kap. 4.2.2 (Datenelemente in der QR-Rechnung), Version 2.4",
    "Header": {
      "QRType": "SPC",
      "Version": "0200",
      "Coding": "1"
    },
    "CdtrInf": {
      "IBAN": "CH4431999123000889012",
      "Cdtr": {
        "AdrTp": "S",
        "Name": "Max Muster & Söhne",
        "StrtNmOrAdrLine1": "Musterstrasse",
        "BldgNbOrAdrLine2": "123",
        "PstCd": "8000",
        "TwnNm": "Seldwyla",
        "Ctry": "CH"
      }
    },
    "UltmtCdtr": {
      "AdrTp": "",
      "Name": "",
      "StrtNmOrAdrLine1": "",
      "BldgNbOrAdrLine2": "",
      "PstCd": "",
      "TwnNm": "",
      "Ctry": ""
    },
    "CcyAmt": {
      "Amt": "1949.75",
      "Ccy": "CHF"
    },
    "UltmtDbtr": {
      "AdrTp": "S",
      "Name": "Simon Muster",
      "StrtNmOrAdrLine1": "Musterstrasse",
      "BldgNbOrAdrLine2": "1",
      "PstCd": "8000",
      "TwnNm": "Seldwyla",
      "Ctry": "CH"
    },
    "RmtInf": {
      "Tp": "QRR",
      "Ref": "210000000003139471430009017",
      "AddInf": {
        "Ustrd": "Auftrag vom 15.10.2020",
        "Trailer": "EPD",
        "StrdBkgInf": "//S1/10/1234/11/201021/30/102673386/32/7.7/40/0:30"
      }
    },
    "AltPmtInf": {
      "AltPmt": [
        "eBill/B/simon.muster@example.com",
        ""
      ]
    }
  }
}

Fußzeile nur auf der ersten Seite (Word und LibreOffice)

Der Zahlteil sitzt typischerweise unten auf der ersten Seite. Ziel: In der Fußzeile keinen Rand links, keinen rechts und keinen nach unten (kein sichtbarer Leerraum unterhalb des Zahlteils am Blattunterrand). Die folgenden Schritte beziehen sich auf die Fußzeile bzw. deren Abstand zum unteren Seitenrand — nicht auf die Seitenränder des normalen Fließtexts (Bildschirmbezeichnungen je nach Version leicht abweichend).

Microsoft Word

1. Erste Seite anders: Fußzeilenbereich öffnen (Doppelklick unten auf die Seite) → unter Kopf- und Fußzeilentools die Option Erste Seite anders aktivieren, damit die erste Seite eine eigene Fußzeile erhält.
2. Abstand Fußzeile von unten 0 cm: Weiterhin bei Kopf- und Fußzeilentools im Bereich Position den Wert Abstand von unten (Fußzeilenabstand vom unteren Seitenrand) auf 0 cm setzen.
3. Linker und rechter Rand in der Fußzeile 0 cm: Fußzeile der ersten Seite bearbeiten → den Absatz mit dem Lookup (bzw. die gesamte Fußzeile) markieren → Start → Dialog Absatz (oder Rechtsklick → Absatz) → Einzug Links und Rechts jeweils 0 cm. Damit ändern Sie nur die Formatierung innerhalb der Fußzeile, nicht die Seitenränder des Fließtexts. Steuern Sie bei Bedarf zusätzlich Kopf- und Fußzeilentools → Mit Seitenrändern ausrichten, damit der Fußzeileninhalt nicht ungewollt an den Text-Rändern des Abschnitts hängen bleibt.
4. In die Fußzeile der ersten Seite die Teil‑Vorlage einfügen, z. B. als Textinhalt <<refLookup:template.chQRinvoiceFooter>> (leere Absätze in der Fußzeile vermeiden, damit nichts den Zahlteil nach oben schiebt).

Referenz zur Steuerung von Kopf- und Fußzeilen in Word: Microsoft Support – Kopf- oder Fußzeile bearbeiten.

LibreOffice Writer

1. Eigene erste Seite: Arbeiten Sie mit der Seitenvorlage Erste Seite und einer Folgevorlage (Standard) oder legen Sie eigene Seitenstile an. Anleitung: LibreOffice Hilfe – Unterschiedliche Kopf- und Fußzeilen definieren.
2. Fußzeilenränder und Abstand unten: Für den Seitenstil der ersten Seite Format → Seitenvorlage → Register Fußzeile aktivieren. Linker Rand und Rechter Rand beziehen sich hier auf die Fußzeile selbst — setzen Sie beide auf 0 cm, damit der Zahlteil seitlich nicht zusätzlich eingerückt wird. Den Abstand (Abstand zwischen Textkörper und Fußzeile) nur so groß wählen, wie Ihr Layout erfordert. Die 0 cm vom unteren Seitenrand erreichen Sie, indem Sie im Register Seite den unteren Seitenrand so bemessen, dass der Fußzeilenbereich inkl. Zahlteil ohne Leerraum darunter auskommt — ohne dafür die linken und rechten Seitenränder der Seite (für den normalen Text) auf 0 zu stellen.
3. In die Fußzeile des ersten Seitenstils <<refLookup:template.chQRinvoiceFooter>> einfügen.

Nächste Schritte: