Zum Hauptinhalt springen
PDF4me APIIntegrationenWissensdatenbankErweiterungenAPI-TesterBlog

Einfügen einer Schweizer QR-Rechnung auf einer benutzerdefinierten Seitenzahl in Power Automate (4-Aktionen-Dropbox-Flow mit PDF4me)

· 21 Minuten Lesezeit
Sankalp Mishra
SEO and Content Writer

Die meisten Anleitungen für Schweizer QR-Rechnungen zeigen, wie der Zahlungsbeleg auf dem Zahlungsabschnitt platziert wird. Seite 1 (oder hängen Sie es ans Ende an). Echte Rechnungen benötigen dies oft. irgendwo in der MitteEin 10-seitiges Vertragspaket, bei dem die QR-Rechnung direkt nach der Zusammenfassung steht, oder ein Quartalsbericht, bei dem der Beleg nach dem Deckblatt folgen soll. Der PDF4me Power Automate Connector erledigt das in einem einzigen Schritt. Paging-Optionen = benutzerdefiniert plus ein Seitenzahl Feld. Diese Anleitung beschreibt den genauen Ablauf, der im Canvas erfasst wird: /pdf4metest/sample/10 page.pdf wird zu einer schweizerkonformen Datei, in die der QR-Code eingefügt ist Seite 3dann hochgeladen auf /pdf4meoutput mit einem GUID-Präfix im Namen, damit es bei erneuten Ausführungen nicht zu Konflikten kommt. 4 Aktionen, kein Code, Ausführung in Sekundenschnelle.

Der Fluss im Überblick
1. Manually trigger a flow
Manual trigger for testing. Swap for any storage trigger in production.
2. Dropbox Get file content
Reads /pdf4metest/sample/10 page.pdf with Infer Content Type Yes.
3. PDF4me Barcode - Create SwissQR Bill
Output Format Type PNG (try PDF for hybrid). Paging Options custom, Page Number 3. All payment fields filled.
4. Dropbox Create file
Writes to /pdf4meoutput. File Name built from guid() plus headers/FileName so every run lands as a unique file.
Die Kurzfassung

Vier Power Automate-Aktionen. Manuelle Auslösung startet den Ablauf. Dropbox Dateiinhalt abrufen liest /pdf4metest/sample/10 page.pdf mit Inhaltstyp ableiten Auf Ja setzen. PDF4me Barcode – SwissQR-Rechnung erstellen fügt eine den Schweizer Zahlungsnormen entsprechende QR-Rechnungsseite hinzu mit Ausgabeformattyp PNG (in diesem Lauf; wählen Sie PDF für den Hybridcontainer, plus JPEG Und Tiff verfügbar), IBAN CH4431999123000889012, Menge 5253531, Währung CHF, Referenztyp QRR, Sprache Englisch, Trennlinie LinieMitSchereGläubiger Var Schneider AG (Adresse S, Biel 2501), Endschuldner Pia-Maria Rutschmann-Schnyder (Adresse S, Biel 9400), Referenz 210000000003139471430009017sowie alle Parameter der alternativen AV1- und AV2-Schemata. Unter Erweiterte Parameter: Paging-Optionen Brauch Und Seitenzahl 3Dropbox Datei erstellen schreibt an /pdf4meoutput mit Dateiname gebaut aus guid() + headers/FileName Zur Gewährleistung der Eindeutigkeit. Ausgabe: Eine von Schweizer Banken scannbare Datei im Archivordner.

Drei Faktoren entscheiden darüber, ob Ihre Ausgabe banklesbar ist UND auf der richtigen Seite landet.

Zunächst einmal die Die IBAN muss mit CH oder LI beginnen. und maximal 21 Zeichen lang sein. Für den QRR-Referenztyp muss die IBAN ein QR-IBANEs handelt sich nicht um eine Standard-IBAN. Zweitens: Wenn der Referenztyp QRR ist, handelt es sich bei der Referenz um eine 27-stellige Zahl mit Modulo-10-PrüfzifferFalls Sie keinen haben, wechseln Sie zu PUNKTZAHL oder NICHT. Dritte, Paginierungsoptionen und Seitenzahlen gelten nur, wenn das Ausgabeformat PDF ist.Die Bildformattypen (PNG, JPEG, Tiff) werden ignoriert, da es sich bei der Ausgabe um ein eigenständiges Zwischenbild und nicht um ein mehrseitiges Dokument handelt.

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

Menschen suchen nach genau diesem Problem mit Formulierungen wie:

  • „Wie füge ich in Power Automate einen Schweizer QR-Code auf einer bestimmten Seite meiner PDF-Datei ein?“ Ausgabeformattyp verwenden PDFPaging-Optionen customund Seitenzahl mit dem 1-basierten Seitenindex (3 in diesem Leitfaden).
  • Kann ich den Schweizer QR-Code als PNG-Bild anstatt als PDF-Seite ausgeben? Ja. Ausgabeformattyp festlegen auf PNG, JPEG, oder Tiff Die Aktion gibt ein eigenständiges Bild des Belegs zurück, wobei die Paging-Optionen ignoriert werden.
  • „Wie kann ich sicherstellen, dass der Name meiner Ausgabedatei bei wiederholten Ausführungen nicht mit dem Namen einer anderen Ausgabedatei kollidiert?“ Verwenden Sie ein guid() Power Automate-Ausdruck im Feld „Dateiname“ des Dropbox-Uploads, optional verkettet mit headers/FileName aus der PDF4me-Ausgabe.
  • „Was gehört zu den erweiterten Parametern der Power Automate-Aktion?“ Vier Felder: Seitenzahl, Paginierungsoptionen, Dateiinhalt (Quell-PDF), Dateiname. Klicken Sie hier. Alle anzeigen auf Erweiterte Parameter, um diese anzuzeigen.
  • „Können Schweizer Banken QR-Codes im PNG-Format scannen?“ Ja. Die QR-Codierung ist in PDF- und Bilddateien identisch. PNG eignet sich für E-Mails oder in Webseiten eingebettete Belege; PDF für die vollständige Rechnung mit Beleg.

Was Sie aufbauen​

Ein wiederverwendbarer Power Automate-Workflow mit 4 Aktionen, der eine von Schweizer Banken scannbare Rechnung mit QR-Code erstellt. welche Seite Sie auch immer wählenDer gleiche Ablauf wird auch für den Fall von eigenständigen Bildern angewendet (Quell-PDF überspringen, Ausgabeformat auf PNG / JPEG / Tiff ändern) bei in E-Mails eingebetteten Zahlungserinnerungen.

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 /pdf4metest/sample als Quellordner und /pdf4meoutput als Ziel. Jeder Speicher funktioniert: SharePoint, OneDrive, Dataverse – alles funktioniert gleich.
  • Eine Rechnung im PDF-FormatDie Laden Sie die 10-seitige Leseprobe herunter. Folgen Sie den Anweisungen anhand der Screenshots genau.
  • Schweizer Zahlungsdaten: CH oder LI IBAN (max. 21 Zeichen), Betrag, Währung (CHF oder EUR), vollständige Namens- und Adressblöcke für Gläubiger und Schuldner. Vollständige Feldreferenz in der AktionsdokumenteDie

Kurzübersicht: Die 4 Felder, die das Ergebnis bestimmen​

Output Format Type
PDF (hybrid), PNG, JPEG, or Tiff. Picks the container of the populated output.
Paging Options
first, last, add at end, or custom. PDF Output Format Type only.
Page Number
1-based page index. Required when Paging Options is custom; ignored otherwise. Set to 3 in this run.
File Content + File Name
The source PDF, mapped from a previous action. Skip both for a standalone QR-slip from payment data alone.

Den Ablauf gestalten​

Aktion 1: Einen Ablauf manuell auslösen​

Manueller Auslöser für Testzwecke. Im Produktivbetrieb austauschen. 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​

Die Aktion, die die Arbeit erledigt. Suche nach PDF4me im Aktionsauswahlfeld und Auswählen Barcode – SwissQR-Rechnung erstellenDie Aktion enthält die Zahlungsfelder im Hauptbereich und 4 Felder darunter. Erweiterte Parameter (Paging-Optionen, Seitenzahl, 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 ausgefüllte Datei unter einem eindeutigen, mit einer GUID beginnenden Namen, damit es bei erneuten Ausführungen nicht zu Konflikten 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() und headers/FileName-Ausdruck sowie dynamischem Dateiinhalt aus der PDF4me-Aktion „SwissQR-Rechnung erstellen“.

Der guid() Der Ausdruck im Dateinamen garantiert bei jeder Ausführung einen eindeutigen Namen. Verkettung Header/Dateiname Die PDF4me-Ausgabe behält den ursprünglichen Rechnungsnamen im neuen Dateinamen bei.

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

Get your API KeyFull action reference

Die 4 Ausgabeformat-Optionen, nebeneinander​

PDF
Hybrid output: QR-bill page inserted into your source invoice. Most common for outgoing AR. Uses Paging Options + Page Number.
PNG
Standalone raster image of the QR-bill slip. Best for inline email embeds and web previews. Ignores Paging Options.
JPEG
Compressed raster image. Smaller file size than PNG. Still bank-scannable.
Tiff
Lossless raster archive format. Use when the recipient needs print-grade quality.

Fehlerbehebung​

QR-bill landed on the wrong page
Check Paging Options. custom uses Page Number. first puts the slip as the new page 1. last appends at the end. Only applies when Output Format Type is PDF.
Page Number is greyed out / ignored
Paging Options is something other than custom. Switch Paging Options to custom and the Page Number field becomes active.
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.
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​

Slip on a specific mid-document page
Quarterly statement where the QR-bill belongs right after the cover page. Contract pack with the slip after the summary.
Inline email PNG payment reminders
Output Format Type PNG, skip the source PDF, embed the slip image directly in an Outlook Send email body.
High-volume AR archival
guid()-prefixed Dropbox upload makes every run uniquely addressable for downstream search and audit.
Subscription billing
QR-IBAN plus QRR Reference identifies the customer or contract every recurring run.

Was Sie als Nächstes lesen sollten​

Häufig gestellte Fragen​

How do I insert the Swiss QR-bill on a specific page in Power Automate?+
Click Show all on Advanced parameters in the PDF4me Barcode - Create SwissQR Bill action. Set Paging Options to custom, then set Page Number to the 1-based page index where the QR-bill should land (3 in this guide). Output Format Type must be PDF for Paging Options to take effect.
What is the difference between Paging Options values first, last, add at end, and custom?+
first inserts the QR-bill as the new page 1 (everything else shifts down by one). last appends at the very end of the source PDF. add at end is a functional alias for last. custom uses the Page Number field to insert at a specific 1-based position.
Why does the QR-bill not move when I change Paging Options?+
Output Format Type is set to PNG, JPEG, or Tiff. Image formats ignore Paging Options because the output is a standalone slip image, not a multi-page document. Switch Output Format Type to PDF.
Can I generate a Swiss QR-bill image (PNG) without a source invoice?+
Yes. Set Output Format Type to PNG (or JPEG / Tiff). Skip the File Content and File Name fields under Advanced parameters. The action returns a standalone QR-bill image you can embed inline in an Outlook email or display on a web page.
Why use guid() in the Dropbox Create file File Name?+
It guarantees every run lands as a unique file in /pdf4meoutput so re-runs do not silently overwrite previous outputs. Concatenating headers/FileName from the PDF4me output keeps the original invoice name inside the new filename for traceability.
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 and the recommended choice for new integrations. PostalCode and City go in separate fields; Address Line 1 / 2 carries the street. K (Combined) puts the full address into two free-text Address Line fields and leaves PostalCode and City empty.
Same flow 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 action reference page.

Los geht's!​

Get your API KeyPDF4me ConnectAction reference