Zum Hauptinhalt springen

Fügen Sie in Make einer beliebigen PDF-Rechnung einen Schweizer QR-Code hinzu: Ein Dropbox-Workflow mit 3 Modulen

· 20 Minuten Lesezeit
SEO and Content Writer

Jede Schweizer Rechnung muss einen Schweizer QR-Schein So können Banken und Buchhaltungssoftware die Zahlung automatisch scannen und verarbeiten. Bei Make und PDF4me ist diese Ergänzung ein Drei-Modul-SzenarioDropbox Datei herunterladenPDF4me Erstellen Sie einen Schweizer QR-RechnungsscheinDropbox Datei hochladenDie folgenden Screenshots veranschaulichen den genauen Ablauf, der im Canvas dargestellt ist: eine 10-seitige Rechnung bei /pdf4metest/Files/10 page.pdf wird zu einer schweizerkonformen Rechnung mit beigefügtem Zahlungsbeleg und wird gespeichert auf /pdf4meoutput/In weniger als 10 Minuten produktionsbereit.

Das Szenario im Überblick
1. Dropbox Download a File
Reads /pdf4metest/Files/10 page.pdf. Scheduled trigger (clock badge) is shown but any trigger works.
2. PDF4me Create Swiss QR-bill
Appends the QR payment slip to the source PDF. Currency, IBAN, creditor + debtor blocks, reference filled out.
3. Dropbox Upload a File
Writes the populated PDF to /pdf4meoutput/. File Name and Data mapped from the prior step.
Die Kurzfassung

Drei Make-Module. Dropbox Datei herunterladen ruft die Quellrechnung ab (der Screenshot zeigt YnooxTestone Verbindung, Wählen Sie eine Datei aus, Weg /pdf4metest/Files/10 page.pdfPDF4me Erstellen Sie einen Schweizer QR-Rechnungsschein fügt eine den Schweizer Zahlungsnormen entsprechende QR-Rechnungsseite hinzu (Formattyp) PDFPaging-Optionen Erste, Währung CHF, IBAN beginnend mit CH(vollständige Gläubiger- und Schuldnerblöcke). Dropbox Datei hochladen schreibt das Ergebnis an /pdf4meoutput/ mit Datei eingestellt auf Karte, Dateiname = 6. Name, Daten = 6. DokumentDie erstellte PDF-Datei kann per E-Mail versendet und mit den QR-Code-Scannern aller mobilen Apps von Schweizer Banken gescannt werden.

Zwei Faktoren entscheiden darüber, ob Ihre Ausgabe bankscannbar ist.

Zunächst einmal die Die IBAN muss mit CH oder LI beginnen. und maximal 21 Zeichen lang sein. Bei einem QRR-Referenztyp muss die IBAN ein QR-IBAN, keine Standard-IBAN. Zweitens, wenn Referenztyp ist QRR, Die Das Referenzfeld ist eine 27-stellige numerische Zeichenfolge mit einer Modulo-10-Prüfziffer.Falls Sie keinen Referenztyp haben, legen Sie ihn auf fest. PUNKTZAHL (ISO 11649) oder NICHT Lassen Sie das Feld „Referenz“ leer. Banken lehnen falsch eingegebene Referenzwerte ab, nicht das QR-Bild.

Häufige Probleme aus dem Alltag, die damit gelöst werden

Menschen suchen nach genau diesem Problem mit Formulierungen wie:

  • Wie kann ich automatisch einen Schweizer QR-Code zu meiner PDF-Rechnung hinzufügen? Laden Sie die Rechnung in Dropbox hoch; dieses 3-Modul-Szenario erledigt den Rest, einschließlich IBAN, Betrag, Referenz und Gläubiger-/Schuldnerdaten.
  • Kann Make aus einer bestehenden Rechnung eine Schweizer QR-Rechnung generieren? Ja. Über das PDF4me-Modul „Swiss QR-Rechnung erstellen“. Das Ergebnis ist dasselbe PDF, in dem der Zahlungsbeleg auf der von Ihnen gewählten Seite (erste/letzte/bestimmte Seite) eingefügt wird.
  • "Benötige ich eine Excel-Vorlage oder eine QR-Code-Bibliothek?" Nein. Das Modul verbirgt die gesamte QR-Code-Generierung, die Modulo-10-Referenzrechnung und das Layout gemäß den Schweizer Zahlungsnormen hinter einem einzigen konfigurierbaren Schritt.
  • „Was ist, wenn ich keine bestehende PDF-Rechnung habe? Kann ich trotzdem einen separaten QR-Code-Beleg generieren?“ Ja. Wenn Sie die Dateigruppe komplett überspringen, gibt das Modul eine eigenständige PDF-Datei mit einem Schweizer QR-Code zurück.
  • Werden die Schweizer Banken diese Ergebnisse tatsächlich akzeptieren? Das Modul erstellt einen den Schweizer Zahlungsnormen ISO 20022 entsprechenden Beleg. Jeder Mobile-Banking-App einer Schweizer Bank kann diesen zur Zahlungsinitiierung scannen.

Was Sie aufbauen

Ein wiederverwendbares Make-Szenario mit drei Modulen. Wird ein Trigger ausgelöst (manuell, geplant, Dateiüberwachung, beliebig), wird die Quellrechnung abgerufen, die Schweizer QR-Rechnung angehängt und die Ausgabe gespeichert. Dasselbe Verfahren eignet sich für einmalige Tests, geplante Stapelverarbeitungen oder die vollständig ereignisgesteuerte Rechnungsverarbeitung.

Szenario-Canvas erstellen: Dropbox-Datei herunterladen (mit Zeitschaltuhr) verbunden mit PDF4me „Schweizer QR-Rechnung erstellen“, welches wiederum mit Dropbox „Datei hochladen“ verbunden ist. Drei große, kreisförmige Modulsymbole sind mit den standardmäßigen gestrichelten Linien von „Erstellen“ verbunden.

Drei Module in einem. Das Uhrsymbol auf Dropbox 1 signalisiert einen geplanten Auslöser. Wechseln Sie je nach Anwendungsfall zu manueller Auslösung oder Webhook.


Was Sie benötigen

  • Machen Konto mit einem offenen Szenario. Erstellen Sie ein Make-Konto Falls Sie einen benötigen.
  • PDF4me API-SchlüsselDie Holen Sie sich Ihren API-Schlüssel Fügen Sie es hinzu, wenn PDF4me nach einer Verbindung fragt. Siehe Verbinde PDF4me, um zu erstellenDie
  • Dropbox mit einem Quellordner (z.B. /pdf4metest/Files/) und ein Ausgabeverzeichnis (/pdf4meoutput/Jeder Speicherdienst funktioniert auf die gleiche Weise. Wechseln Sie je nach Bedarf zu Google Drive, OneDrive oder SharePoint.
  • Eine Rechnung im PDF-Format (die Screenshots verwenden 10 Seiten.pdfOptional: Die Quelldatei kann übersprungen und ein eigenständiger QR-Code nur aus den Zahlungsdaten generiert werden.
  • Schweizer Zahlungsdaten: A CH oder LI IBAN, Betrag, Währung (CHF oder EUR), und Gläubiger- + Schuldnernamen-/Adressblöcke. Vollständige Feldreferenz in der AktionsdokumenteDie

Erstellen Sie das Szenario

Modul 1: Dropbox – Eine Datei herunterladen

Ziehen Sie die Quellrechnung aus Ihrem Eingabeordner.

FeldIn diesem Lauf verwendeter Wert
ConnectionYnooxTestone (ynoox.test...). your Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Files/10 page.pdf
Dropbox-Datei-Download-Konfiguration. Verbindung auf YnooxTestone eingestellt. Dateiauswahlmethode: Datei auswählen. Dateipfad: /pdf4metest/Files/10 page.pdf. Schaltflächen „Abbrechen“ und „Speichern“ unten.

Dropbox-Datei herunterladen (Konfiguration). Wählen Sie die Datei über die Pfadauswahl aus oder verwenden Sie für die Stapelverarbeitung die entsprechende Funktion. Dateien durchsuchen und Datei dynamisch binden.

Modul 2: PDF4me – Erstellung einer Schweizer QR-Rechnung

Suchen nach PDF4me und wählen Erstellen Sie einen Schweizer QR-RechnungsscheinDas Modul stellt 26 Felder bereit. Die vollständige Referenz für jedes Feld (mit den 5 detaillierten UI-Screenshots und Beispielwerten wie Var Schneider AG, CH4431999123000889012, Pia-Maria Rutschmann-Schnyder) befindet sich auf der Erstellen Sie eine SwissQR-Rechnung in Make Aktionsseite. Mindesteinstellungen:

GruppeFeldWert
SourceFileDropbox - Download a File (pulls from Module 1 automatically)
OutputFormat TypePDF
OutputPaging OptionsFirst (also: Last, or a specific 1-based page number)
PaymentCurrencyCHF (or EUR)
PaymentReference TypeQRR, SCOR, or NON
PaymentLanguageEnglish / German / French / Italian
PaymentSeparator LineLine With Scissor, Only Line, or No Line
PaymentAmounte.g. 1250.00
PaymentIBANCH or LI IBAN, max 21 chars
CreditorCreditor Address TypeS (Structured) or K (Combined)
CreditorCreditor NameCompany name on the account
DebtorUltimate Debtor AddressTypeS or K

Füllen Sie die Felder für die Gläubiger- und Schuldneradresse entsprechend Ihrer Auswahl des Adresstyps aus, anschließend alle optionalen Referenz-/Unstrukturierte-Nachricht-/Rechnungsinformationen-/AV1-/AV2-Parameter.

Modul 3: Dropbox – Eine Datei hochladen

Schreibe die ausgefüllte PDF-Datei in den Ausgabeordner.

FeldIn diesem Lauf verwendeter Wert
ConnectionYnooxTestone (ynoox.test...). same Dropbox connection as Module 1
Folder/pdf4meoutput/
FileMap (so File Name and Data come from the PDF4me step)
File Name6. Name (dynamic content from PDF4me Module 2)
Data6. Document (dynamic content from PDF4me Module 2)
Dropbox-Datei-Upload-Konfiguration erstellen. Verbindung: YnooxTestone. Ordner: /pdf4meoutput/. Dateityp: Map. Dateiname: Name (aus „PDF4me Schweizer QR-Rechnung erstellen“). Datentyp: Dokument. Hinweis: Dateiname inklusive Dateiendung, z. B. invoice.xml.

Das Radio „File“ ist auf „“ eingestellt. Karte Dateiname und Daten werden als separate Felder bereitgestellt. Binden Sie beide an die Ausgänge des PDF4me-Moduls 2, damit die befüllte PDF-Datei unverändert gespeichert wird.

Speichern und klicken Einmal ausführenDie ausgefüllte Rechnung wird angezeigt in /pdf4meoutput/ innerhalb weniger Sekunden.


Was landet im Ausgabeverzeichnis?

Eine einzelne PDF-Datei, benannt nach der Quelle (z.B. 10 page.pdf) mit der an der gewählten Position eingefügten Schweizer QR-Rechnungsseite in Paging-Optionen (First setzt es als neue Seite 1; Last (wird am Ende angehängt). Öffnen Sie die Datei in einem beliebigen PDF-Viewer. Im Abschnitt „QR-Rechnung“ werden der Zahlungs-QR-Code, die lesbare Konto-/Zahlungsadresse, der Betrag, die Währung, der Verwendungszweck sowie die Adressen von Gläubiger und Schuldner angezeigt. Scannen Sie den QR-Code mit einer Schweizer Banking-App, und die Zahlung wird automatisch ausgefüllt.


Kurzübersicht: Wichtigste Parameter

IBAN
CH or LI prefix, max 21 chars. QR-IBAN required for QRR references.
Currency
CHF or EUR only. Anything else is rejected by the Swiss Payment Standards.
Reference Type
QRR (27-digit + mod-10), SCOR (ISO 11649), or NON. Pick once, fill Reference accordingly.
Address Type
S = structured (separate PostalCode + City). K = combined (full address in two AddressLines).
Paging Options
First, Last, or a 1-based page number. Decides where the QR-bill page lands.
AV1 / AV2
Alternative scheme parameters for eBill and similar. Format: Name AV1: UV;value;id.

Fehlerbehebung

QR-bill page is blank or the QR code is unreadable
The IBAN is invalid (must start with CH or LI, max 21 chars) or the Currency was something other than CHF / EUR. Both are hard requirements of the Swiss Payment Standards.
Reference Type QRR but the bank rejects the reference
QRR references must be 27 digits with a mod-10 check digit. If you do not have one, switch Reference Type to SCOR (ISO 11649) or NON and leave Reference empty.
QR-bill landed on the wrong page
Adjust Paging Options. First puts the slip as the new page 1. Last appends it after the last page. Or pass a 1-based page number to insert at that position.
Creditor or Debtor address looks wrong on the slip
Mismatched Address Type. With type S, fill PostalCode + City and use AddressLine1/2 for street. With type K, leave PostalCode + City empty and put the full address into AddressLine1 + AddressLine2.
Upload writes a zero-byte file
File Name or Data in the Upload module is not bound to the PDF4me Module 2 outputs. Click the field and re-pick the dynamic content from Module 6 (PDF4me Create Swiss QR-bill).
Want a standalone QR slip without an invoice
Skip the source file entirely. Remove Dropbox Module 1, or leave the File group empty in the PDF4me module. The output is a standalone Swiss QR-bill PDF.

Wann man dieses Muster verwendet

Outgoing customer invoices
Bills that need to be Swiss-payable directly from a banking app via QR scan.
Subscription billing
QR-IBAN + 27-digit QRR reference identifies the customer or contract on every recurring run.
Bulk invoice retrofitting
When an existing PDF invoice template does not yet carry the payment slip. Append it via this scenario.
e-Bill replacements / fallbacks
For customers who prefer paper or in-app QR-scan over the electronic Bill flow.

Was Sie als Nächstes lesen sollten


Häufig gestellte Fragen

Do I need a special Swiss QR library or font?+
No. The PDF4me Create Swiss QR-bill module bundles QR-code generation, the QR-bill fonts (Liberation Sans), the mod-10 reference math, and the Swiss Payment Standards layout. Configure the fields, click Run, and the output is a Swiss-compliant PDF.
What is the difference between QRR, SCOR, and NON references?+
QRR is the Swiss 27-digit numeric reference with a mod-10 check digit; it requires a QR-IBAN. SCOR is the international ISO 11649 creditor reference; it works with a standard IBAN. NON means no reference is shown on the slip. useful for ad-hoc one-off payments where the debtor adds their own reference at payment time.
Can I generate a Swiss QR-bill without an existing PDF invoice?+
Yes. Skip the File group in the PDF4me module and the output is a standalone Swiss QR-bill PDF (just the payment slip, no invoice body). Useful when the debtor only needs the slip, or when your invoice body comes from a different source.
My IBAN starts with DE / FR / IT. can I still use this?+
No, Swiss QR-bills are scoped to CH and LI IBANs only. For European SEPA payments with non-Swiss IBANs, use the Generate EPC QR Code for SEPA module instead.
Address Type S vs K. which one should I pick?+
S (Structured) is the modern default: PostalCode and City go in separate fields; AddressLine1/2 carries the street. K (Combined) puts the full address in two free-text AddressLine fields and ignores PostalCode/City. New integrations should use S unless you are importing legacy data that does not separate postal code and city.
Does the output PDF work with mobile banking apps?+
Yes. Every Swiss bank app that supports payments via QR-bill (which is all of them since 2022) can scan the output to pre-fill the payment form. Test by opening UBS, PostFinance, Raiffeisen, or any Swiss banking app and scanning the QR code on the printed or on-screen slip.
How do I change where the QR-bill page lands?+
Set Paging Options. First puts the slip as the new page 1 of the output PDF, Last appends it to the end, or pass a 1-based page number to insert it at that position. Page indexing starts at 1.
Same scenario in n8n, Zapier, or Power Automate?+
Yes. The same PDF4me Create Swiss QR-bill action is available on all four platforms with identical parameters. See the cross-platform comparison at the bottom of the Create SwissQR Bill action page.

Los geht's!