Zum Hauptinhalt springen
PDF4me APIIntegrationenWissensdatenbankErweiterungenAPI-TesterBlog

Fügen Sie in Power Automate einer beliebigen PDF-Rechnung einen Schweizer QR-Code hinzu: Ein Dropbox-Workflow mit 4 Schritten

· 20 Minuten Lesezeit
Sankalp Mishra
SEO and Content Writer

Jede Schweizer Rechnung muss einen Schweizer QR-Schein So können Banken und Buchhaltungssoftware die Zahlung automatisch scannen und verarbeiten. Mit Power Automate und PDF4me ist dies eine zusätzliche Funktion. Vier-Aktions-Fluss: Manuell auslösen, Dropbox Dateiinhalt abrufenPDF4me Barcode – SwissQR-Rechnung erstellenDropbox Datei erstellenDie folgenden Screenshots veranschaulichen den genauen Ablauf, der im Canvas aufgezeichnet wurde. Eine 10-seitige Rechnung in /pdf4metest/sample wird zu einer schweizerkonformen Rechnung mit beigefügtem Zahlungsbeleg und hochgeladen auf /pdf4meoutput mit einem eindeutigen Dateinamen. In weniger als 10 Minuten produktionsbereit.

Der Fluss im Überblick
1. Manually trigger a flow
Manual trigger for testing. Swap for SharePoint When a file is created or any storage trigger in production.
2. Dropbox Get file content
Reads the 10-page invoice from /pdf4metest/sample/10 page.pdf with Infer Content Type Yes.
3. PDF4me Barcode - Create SwissQR Bill
Appends the QR payment slip with CHF, QRR reference, English labels, custom Paging Options to land on page 3.
4. Dropbox Create file
Writes the populated PDF to /pdf4meoutput with a unique guid()+headers/FileName so re-runs do not collide.
Die Kurzfassung

Vier Power Automate-Aktionen. Manuelle Auslösung startet den Ablauf. Dropbox Dateiinhalt abrufen liest /pdf4metest/sample/10 page.pdf Mit der Einstellung „Inhaltstyp ableiten“ auf „Ja“. PDF4me Barcode – SwissQR-Rechnung erstellen fügt eine den Schweizer Zahlungsnormen entsprechende QR-Rechnungsseite hinzu (Ausgabeformattyp) PNG in diesem Durchlauf; wechseln zu PDF für Hybrid-Ausgang, IBAN CH4431999123000889012, Menge 5253531, Währung CHF, Referenztyp QRR, Sprache EnglischTrennlinie LinieMitSchere, Creditor Var Schneider AG, Ultimate Debtor Pia-Maria Rutschmann-Schnyder, Reference 210000000003139471430009017Paging-Optionen Brauch, Seitenzahl 3, Dateiname abc.pdfDropbox Datei erstellen schreibt an /pdf4meoutput mit Dateinamen erstellt aus guid() + Header/Dateiname Zur Gewährleistung der Eindeutigkeit. Das Ergebnis ist eine von Schweizer Banken scannbare Datei im Archivordner.

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

Zunächst einmal die Die IBAN muss mit CH oder LI beginnen. und darf 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, ändern Sie ihn auf 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 in Power Automate automatisch eine Schweizer QR-Rechnung zu meiner PDF-Rechnung hinzufügen?“ Dieser Ablauf mit 4 Schritten erledigt das: Eine PDF-Datei wird in Dropbox abgelegt, der Ablauf wird ausgelöst, und die mit einem QR-Code angereicherte Datei landet im Ausgabeverzeichnis.
  • Kann Power Automate aus einer bestehenden Rechnung eine Schweizer QR-Rechnung generieren? Ja, über die PDF4me-Aktion „Barcode – SwissQR-Rechnung erstellen“. Das Ergebnis ist dasselbe PDF, bei dem der Beleg an der ersten/letzten/einer bestimmten Seite angehängt wird.
  • Benötige ich eine QR-Code-Bibliothek oder ein Abonnement für einen Schweizer QR-Code-Generator? Nein. Die PDF4me-Aktion verbirgt die QR-Code-Generierung, die Modulo-10-Referenzrechnung und das vollständige Layout der Schweizer Zahlungsnormen hinter einem einzigen Power Automate-Schritt.
  • "Was ist, wenn ich keine PDF-Quelldatei habe? Kann ich dann einen eigenständigen QR-Code generieren?" Ja. Überspringen Sie die Felder „Dateiinhalt“ und „Dateiname“ unter „Erweiterte Parameter“; die Aktion gibt eine eigenständige QR-Rechnung im gewählten Ausgabeformat (PDF / PNG / JPEG / TIFF) zurück.
  • Werden die Schweizer Banken diese Ergebnisse akzeptieren? Dabei wird ein Beleg erzeugt, der den Schweizer Zahlungsnormen ISO 20022 entspricht. Jede Mobile-Banking-App einer Schweizer Bank kann diesen Beleg zur Zahlungsinitiierung scannen.

Was Sie aufbauen​

Ein wiederverwendbarer Power Automate-Flow mit vier Aktionen. Nach dem Auslösen des Triggers wird die Quellrechnung aus Dropbox (oder SharePoint/OneDrive/Outlook) abgerufen, die PDF4me-Aktion fügt den QR-Code der Rechnung hinzu und die befüllte Datei wird mit einem GUID-präfix im Namen hochgeladen. Das gleiche Verfahren funktioniert für ausgehende Kundenrechnungen, geplante Stapelverarbeitungen oder ereignisgesteuerte Debitorenbuchhaltung.

Power Automate Flow-Canvas mit vier Aktionen: Manuelles Auslösen eines Flows, Dropbox Dateiinhalt abrufen, Barcode - SwissQR-Rechnung erstellen, Dropbox Datei erstellen.

Vier Aktionen, von oben nach unten. Manuelle Auslösung erleichtert das Testen des Ablaufs; kann durch jede beliebige Speicherauslösung im Produktivbetrieb ersetzt werden.

Was Sie benötigen​

  • Power Automate Konto mit einem offenen Zahlungsfluss. Power Automate öffnenDie
  • PDF4me API-SchlüsselDie Holen Sie sich Ihren API-SchlüsselMelden Sie sich beim ersten Ausführen der Aktion beim PDF4me Connect-Connector an.
  • Dropbox mit einem Quellordner (z.B. /pdf4metest/sample) und ein Ausgabeverzeichnis (/pdf4meoutputJeder Speicherort funktioniert: SharePoint, OneDrive oder Dataverse funktionieren nach dem gleichen Prinzip.
  • Eine Rechnung im PDF-FormatDie Laden Sie die 10-seitige Leseprobe herunter. wurde in den Screenshots verwendet, um genau folgen zu können.
  • 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

Kurzübersicht: Wichtigste Parameter​

Output Format Type
PDF (hybrid), PNG / JPEG / Tiff (standalone images).
IBAN
CH or LI prefix, max 21 chars. QR-IBAN required for QRR references.
Reference Type
QRR (27-digit + mod-10), SCOR (ISO 11649), or NON.
Address Type
S = structured (separate Postal Code + City). K = combined.
Paging Options
first, last, add at end, or custom (uses Page Number). PDF only.
Page Number
1-based page index. Required only when Paging Options is custom.

Den Ablauf gestalten​

Aktion 1: Einen Ablauf manuell auslösen​

Manuelle Auslösung ist die schnellste Testmethode. Im Produktivbetrieb austauschen durch Dropbox Wenn eine Datei erstellt, SharePoint Wenn eine Datei erstellt wird, OneDrive Wenn eine Datei erstellt, Outlook Wenn eine neue E-Mail eintrifft, Wiederauftreten, oder Webhooks abhängig von Ihrer AR-Pipeline.

Aktion 2: Dropbox – Dateiinhalte abrufen​

Ziehen Sie die Quellrechnung aus Ihrem Eingabeordner.

FeldIn diesem Lauf verwendeter Wert
File/pdf4metest/sample/10 page.pdf
Infer Content TypeYes
Power Automate Dropbox-Aktion „Dateiinhalt abrufen“ mit Datei /pdf4metest/sample/10 page.pdf und erweitertem Parameter „Inhaltstyp ableiten“: Ja.

Aktion 3: PDF4me Barcode – SwissQR-Rechnung erstellen​

Suchen nach PDF4me und wählen Barcode – SwissQR-Rechnung erstellenDie Aktion blendet die Zahlungsfelder im Hauptfenster und vier Felder unter „Erweiterte Einstellungen“ ein (Seitennummerierung, Dateiinhalt, Dateiname). Konfigurieren:

GruppeFeldWert
OutputOutput Format TypePNG
PaymentIBANCH4431999123000889012
PaymentAmount5253531
PaymentCurrencyCHF
PaymentReference TypeQRR
PaymentLanguage TypeEnglish
PaymentSeperator LineLineWithScissor
CreditorCreditor NameVar Schneider AG
CreditorCreditor Address TypeS
CreditorCreditor: Address Line 1Var Schneider AG
CreditorCreditor: Address Line 223
CreditorCreditor PostalCode2501
CreditorCreditor Citybiel
DebtorUltimate Debtor NamePia-Maria Rutschmann-Schnyder
DebtorUltimate Debtor AddressTypeS
DebtorUltimate Debtor: Address Line 1Grosse Marktgasse
DebtorUltimate Debtor: Address Line 233
DebtorUltimate Debtor PostalCode9400
DebtorUltimate Debtor Citybiel
Ref/MsgReference210000000003139471430009017
Ref/MsgUnstructured MessageInstruction of 15.09.2019
Ref/MsgBilling InfoS1/01/20170309/11/10201409/20/14000000/22/36958/30/CH106017086/40/1020/41/3010
Ref/MsgAV1 ParametersName AV1: UV;UltraPay005;12345
Ref/MsgAv2 ParametersName AV2: XY;XYService;54321
AdvancedPaging Optionscustom
AdvancedPage Number3
AdvancedFile ContentFile Content (from Action 2)
AdvancedFile Nameabc.pdf

Aktion 4: Dropbox – Datei erstellen​

Speichern Sie die gefüllte Datei im Ausgabeverzeichnis. Erstellen Sie einen eindeutigen Dateinamen mit guid() Damit es nicht zu Überschneidungen bei den Wiederholungen kommt.

FeldIn diesem Lauf verwendeter Wert
Folder Path/pdf4meoutput
File Nameguid() + headers/FileName (concat expression for a unique-per-run name)
File ContentFile Content (from Action 3, dynamic content)
Power Automate Dropbox-Aktion „Datei erstellen“ mit Ordnerpfad /pdf4meoutput, Dateiname aus guid() + headers/FileName-Ausdruck und dynamischem Dateiinhalt aus der PDF4me-Aktion „SwissQR-Rechnung erstellen“.

Der guid() Der Ausdruck im Dateinamen garantiert bei jeder Ausführung einen eindeutigen Namen. Wenn Sie ihn daneben ablegen, Header/Dateiname Die PDF4me-Ausgabe behält den ursprünglichen Rechnungsnamen im Dateinamen bei.

Speichern und klicken PrüfenDie von Schweizer Banken scannbare Datei landet in /pdf4meoutputDie

Get your API KeyFull action reference

Fehlerbehebung​

QR-bill page is blank or unreadable
IBAN is invalid (must start with CH or LI, max 21 chars) or Currency is something other than CHF / EUR. Both are hard requirements of the Swiss Payment Standards.
Bank rejects a QRR 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 under Advanced. first puts the slip as the new page 1. last appends it after the last page. custom uses Page Number for a specific 1-based position.
Creditor or Debtor address looks wrong on the slip
Mismatched Address Type. With S, fill Postal Code + City and use Address Line 1/2 for street. With K, leave Postal Code + City empty and put the full address into Address Line 1 + Address Line 2.
Create file writes an empty file
File Content on Action 4 is not bound to the PDF4me File Content output. Click the field and re-pick the dynamic content from Action 3.
Want a standalone QR slip without a source invoice
Skip Action 2 (Get file content). On Action 3, leave File Content and File Name empty under Advanced parameters and the action returns a standalone Swiss QR-bill in the chosen Output Format Type.

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.
e-Bill fallbacks
For customers who prefer paper or in-app QR-scan over electronic Bill.

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 SwissQR Bill action bundles QR-code generation, the QR-bill fonts (Liberation Sans), mod-10 reference math, and the Swiss Payment Standards layout. Configure the fields, save the flow, and the output is a Swiss-compliant file.
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 Action 2 (Get file content). On Action 3, leave File Content and File Name empty under Advanced parameters; the action returns a standalone Swiss QR-bill in the chosen Output Format Type (PDF, PNG, JPEG, or Tiff).
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 action instead.
Address Type S vs K, which one should I pick?+
S (Structured) is the modern default: PostalCode and City go in separate fields; Address Line 1/2 carries the street. K (Combined) puts the full address in two free-text Address Line fields and ignores PostalCode/City. New integrations should use S unless you are importing legacy data.
Does the output work with mobile banking apps?+
Yes. Every Swiss bank app that supports payments via QR-bill (every major bank 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.
How do I change where the QR-bill page lands?+
Click Show all on Advanced parameters. Set Paging Options to first / last / add at end / custom. For custom, also fill Page Number with the 1-based page index. Only applies when Output Format Type is PDF.
Same scenario in Make, Zapier, or n8n?+
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!​

Get your API KeyPDF4me ConnectAction reference