Create SwissQR Bill in Power Automate

Q: How do I insert the QR-bill on a specific page?

Set Paging Options to custom under Advanced parameters, then set Page Number to the 1-based page index. Paging Options also accepts first, last, and add at end if you do not need a specific position. Only applies when Output Format Type is PDF.

What this action does

PDF4me Barcode - Create SwissQR Bill appends a Swiss Payment Standards compliant QR-bill payment slip to an invoice PDF inside a Power Automate flow, or generates a standalone QR-bill from payment data alone. Pipe File Content from SharePoint, OneDrive, Dropbox, Dataverse, or Outlook attachments; supply IBAN + creditor + debtor + reference fields; pick the output format (PDF, PNG, JPEG, Tiff); and the action returns a Swiss-bank-scannable file ready for downstream Create file, Send email, or Teams message actions. ISO 20022 compliant; accepted by every Swiss banking app since 2022.

Authenticating Your API Request

The PDF4me Connect connector in Power Automate requires a valid connection holding your PDF4me API key. Create the connection once at flow design time, then every PDF4me action in your tenant reuses it.

Get your API Key

Important Facts You Should Not Miss

Four output formats, not just PDF

Output Format Type accepts PDF (hybrid, appended to your source invoice), PNG, JPEG, or Tiff (standalone images of the QR slip). Use image formats for inline email embeds or web previews; use PDF when delivering a complete invoice.

IBAN must be CH or LI, currency CHF or EUR

The Swiss Payment Standards spec restricts IBAN to Swiss / Liechtenstein issuers (max 21 chars) and currency to CHF / EUR. For QRR Reference Type the IBAN must be a QR-IBAN, not a standard IBAN. For other European IBANs use Generate EPC QR Code for SEPA instead.

Paging Options live under Advanced parameters

Click Show all on Advanced parameters to expose Paging Options, Page Number, File Content, and File Name. Set Paging Options to custom + fill Page Number to land the QR-bill on a specific page (1-based). Applies only when Output Format Type is PDF.

Parameters

The action exposes the payment + creditor + debtor + reference fields in the main panel and 4 fields under Advanced parameters that control input file and page placement. The screenshots below mirror the exact field order in the Power Automate UI.

Required (red asterisk in the UI): IBAN, Amount. Strongly recommended for SPS-compliant slips: Output Format Type, Creditor Name, Creditor Address Type, address lines + PostalCode + City, Ultimate Debtor block, Currency, Reference Type, Language Type, Seperator Line. Conditional (Advanced parameters): Page Number when Paging Options is custom; File Content + File Name when appending the QR slip to an existing PDF (skip both for a standalone QR-slip).

Power Automate Create SwissQR Bill action: Block 1: Output Format Type, IBAN, Amount, Creditor Name, Creditor Address Type, Address Lines, PostalCode — Block 1: Output Format Type, IBAN, Amount, Creditor Name, Creditor Address Type, Address Lines, PostalCode

Power Automate Create SwissQR Bill action: Block 2: Creditor City, Currency, Ultimate Debtor block (Name, AddressType, Address Lines, PostalCode, City), Reference Type — Block 2: Creditor City, Currency, Ultimate Debtor block (Name, AddressType, Address Lines, PostalCode, City), Reference Type

Power Automate Create SwissQR Bill action: Block 3: Reference, Unstructured Message, Billing Info, AV1 + Av2 Parameters, Language Type, Seperator Line — Block 3: Reference, Unstructured Message, Billing Info, AV1 + Av2 Parameters, Language Type, Seperator Line

Parameter	Required	What it does	Example
Output Format Type	No	Container of the populated output. PDF (hybrid; appended to source invoice), PNG / JPEG / Tiff (standalone raster image of the QR slip). See the reference card below.	`PNG`
IBAN	Yes	IBAN or QR-IBAN of the creditor. Maximum 21 characters with CH or LI country codes only. QR-IBAN required when Reference Type is QRR.	`CH4431999123000889012`
Amount	Yes	Payment amount with up to 2 decimal places, no leading zeros. Maximum 12 digits total.	`5253531`
Creditor Name	No	Creditor name or company according to the bank account. Maximum 70 characters.	`Var Schneider AG`
Creditor Address Type	No	Address format for the creditor. S (Structured, separate PostalCode and City fields) or K (Combined, two free-text address lines).	`S`
Creditor: Street Name or Address Line 1	No	Creditor primary address line. Maximum 70 characters.	`Var Schneider AG`
Creditor: Building Number or Address Line 2	No	Creditor secondary address line (building number for S, free-text for K). 16 chars (S) or 70 chars (K).	`23`
Creditor PostalCode	No	Creditor postal code. Maximum 16 characters.	`2501`
Creditor City	No	Creditor town or city. Maximum 35 characters.	`biel`
Currency	No	Payment currency. Only CHF and EUR are permitted by Swiss Payment Standards.	`CHF`
Ultimate Debtor Name	No	Debtor name or company. Maximum 70 characters.	`Pia-Maria Rutschmann-Schnyder`
Ultimate Debtor AddressType	No	Same rules as Creditor Address Type. S (Structured) or K (Combined).	`S`
Ultimate Debtor: Street Name or Address Line 1	No	Debtor primary address line. Maximum 70 characters.	`Grosse Marktgasse`
Ultimate Debtor: Building Number or Address Line 2	No	Debtor secondary address line. 16 chars (S) or 70 chars (K).	`33`
Ultimate Debtor PostalCode	No	Debtor postal code. Maximum 16 characters.	`9400`
Ultimate Debtor City	No	Debtor town or city. Maximum 35 characters.	`biel`
Reference Type	No	Reference format. QRR (Swiss 27-digit numeric, requires QR-IBAN), SCOR (ISO 11649 creditor reference), NON (no reference shown).	`QRR`
Reference	No	Payment reference value. Format depends on Reference Type. Maximum 27 characters for QRR.	`210000000003139471430009017`
Unstructured Message	No	Free-text payment description shown in the Additional information block. Maximum 140 characters.	`Instruction of 15.09.2019`
Billing Info	No	Structured billing information (Swico, etc) shown alongside the Unstructured Message. Maximum 140 characters.	`S1/01/20170309/11/10201409/20/14000000/22/36958/30/CH106017086/40/1020/41/3010`
AV1 Parameters	No	Alternative scheme parameter 1 (e.g. eBill identifier). Maximum 100 characters. Convention: Name AV1: UV;...	`Name AV1: UV;UltraPay005;12345`
Av2 Parameters	No	Alternative scheme parameter 2. Maximum 100 characters. Same convention as AV1 when a second alternative scheme is required.	`Name AV2: XY;XYService;54321`
Language Type	No	Language for the printed QR-bill labels. German, French, Italian, English.	`English`
Seperator Line	No	Separator line style. LineWithScissor (line + scissor pictogram, standard print), OnlyLine (line, no pictogram), or NoLine (eBill / e-invoice). The Power Automate UI labels this field with the legacy "Seperator" spelling.	`LineWithScissor`
Paging Options	No (Advanced)	Where the QR-bill page is inserted (PDF Output Format Type only). Options: first, last, add at end, custom. See the reference card below.	`custom`
Page Number	Conditional (Advanced)	The 1-based page number where the QR-bill is inserted. Required when Paging Options is custom; ignored for every other value.	`3`
File Content	No (Advanced)	Source PDF as dynamic content from a prior Microsoft 365 action (SharePoint Get file content, OneDrive Get file content, Dropbox Get file content using path, Outlook Get attachments). Skip for a standalone QR-slip from payment data.	`File Content`
File Name	No (Advanced)	Source filename including .pdf extension. Required when File Content is supplied.	`abc.pdf`

Output Format Type options

Power Automate Output Format Type dropdown showing PNG selected with options JPEG, PDF, PNG, Tiff — The Output Format Type dropdown lists 4 options.

PDF

Standard. Hybrid output: QR-bill page appended to your source invoice (use Paging Options to control where). Most common choice for outgoing invoices.

PNG

Standalone raster image of the QR-bill slip. Best for inline email embeds and web previews. QR stays scannable at high DPI.

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.

Paging Options reference (Advanced parameters)

Applies only when Output Format Type is PDF. Image format types (PNG, JPEG, Tiff) ignore Paging Options because the output is a standalone QR slip image, not a multi-page document.

Power Automate Advanced parameters expanded showing Page Number 3, Paging Options custom, File Content and File Name slots — Advanced parameters expanded: Page Number 3, Paging Options custom, mapped File Content, File Name abc.pdf.

first

Insert the QR-bill as the new page 1 of the output. The original first page becomes page 2.

last

Insert the QR-bill at the end, after the original last page.

add at end

Functional alias for last. Pick whichever phrasing matches your downstream documentation.

custom

Insert the QR-bill at a specific 1-based page index. Requires Page Number to be filled with the desired index (e.g. 3 inserts the slip as the new page 3).

Output

Field	Type	What it contains
`File Content`	Binary	The populated Swiss QR-bill output in the chosen Output Format Type. Pass into SharePoint Create file, OneDrive Create file, Outlook Send an email, or Teams Post a message.
`File Name`	String	Output filename, based on the input File Name (or a default if no source file was provided).

Sample file

10 page sample invoice

Use as the source PDF when testing the action end-to-end. Pair with the field values from the screenshots above.

Quick Setup

Add PDF4me to Barcode - Create SwissQR Bill in your Power Automate flow.
Sign in to the PDF4me Connect connector with your API key.
Set Output Format Type to PDF (or PNG / JPEG / Tiff for image output).
Fill the payment fields: IBAN (CH or LI, max 21 chars), Amount, Currency (CHF or EUR), Reference Type (QRR, SCOR, or NON), Language Type, Seperator Line.
Fill the Creditor block (Name, AddressType, address lines, PostalCode, City) and Ultimate Debtor block.
Optionally fill Reference, Unstructured Message, Billing Info, AV1 / Av2 Parameters.
Click Show all on Advanced parameters. Map File Content and File Name from a prior action (SharePoint, OneDrive, Dropbox, Outlook). Set Paging Options to first / last / add at end / custom. If custom, fill Page Number with the 1-based page index where the slip should land (e.g. 3).
Save and run. The action returns File Content with the populated PDF or image. Pipe into SharePoint Create file, OneDrive Create file, Outlook Send an email, or Teams Post a message.

Flow examples

Common Power Automate flow patternsThree ways to chain Create SwissQR Bill into a flow.

SharePoint invoice library to email

SharePoint When a file is created trigger fires on /Documents/Invoices.
SharePoint Get file content loads the PDF binary.
Create SwissQR Bill appends the payment slip (Output Format Type PDF, Paging Options last).
Outlook Send an email attaches the populated PDF to the customer.

Dropbox archive workflow

Manually trigger a flow (or Dropbox When a file is created).
Dropbox Get file content using path reads /pdf4metest/sample/10 page.pdf.
Create SwissQR Bill appends the slip with Paging Options custom, Page Number 3.
Dropbox Create file writes to /pdf4meoutput with a unique filename built from guid() + the source name.

Standalone QR slip from Dataverse data

Recurrence trigger fires daily.
Dataverse List rows pulls overdue invoices.
Apply to each: Create SwissQR Bill without File Content (skip Advanced File fields) using payment data from the row. Output Format Type PNG.
Outlook Send an email embeds the QR PNG inline with a payment reminder.

Frequently Asked Questions

What output formats does Create SwissQR Bill produce?+

Four: PDF (hybrid output with the QR-bill page appended to the source invoice, most common), PNG, JPEG, or Tiff (standalone raster images of the QR-bill slip). The PDF output also honors the Paging Options field to control where the slip is inserted.

How do I insert the QR-bill on a specific page?+

Click Show all on Advanced parameters. Set Paging Options to custom, then fill Page Number with the 1-based page index where the slip should land. Paging Options also accepts first, last, and add at end if you do not need a specific position. Only applies when Output Format Type is PDF.

What is the difference between QRR, SCOR, and NON?+

QRR is the Swiss 27-digit numeric reference with a mod-10 check digit; it requires a QR-IBAN. SCOR is the ISO 11649 international creditor reference; it works with a standard IBAN. NON means no reference is shown on the slip, useful for ad-hoc payments where the debtor adds their own reference.

Can I generate a standalone QR-bill without a source PDF?+

Yes. Skip the File Content and File Name fields in Advanced parameters. The action returns a standalone Swiss QR-bill in the chosen Output Format Type. Useful when the debtor only needs the payment slip.

Address Type S or K which one should I pick?+

S (Structured) is the modern default and the recommended choice for new integrations. Fill PostalCode and City as separate fields, with the street going on Address Line 1 / 2. K (Combined) puts the full address as free text on the two Address Line fields and leaves PostalCode / City empty. Use K only when importing legacy data.

What does the Seperator Line field control?+

The separator pictogram printed on the QR-bill section. LineWithScissor (a line plus scissor icon, the standard for paper invoices), OnlyLine (a line, no pictogram), or NoLine (no separator, used in eBill / e-invoice scenarios where the slip will not be cut). The Power Automate UI labels the field with the legacy Seperator spelling.

Will Swiss banks actually accept this output?+

Yes. The action produces an ISO 20022 Swiss Payment Standards compliant slip. Every Swiss bank app that supports QR-bill payments (every major bank since 2022) can scan the output to pre-fill the payment form.

My IBAN starts with DE, FR, or 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.

Read SwissQR Code

Inverse action: extract structured payment data from a Swiss QR-bill PDF.

Generate EPC QR Code for SEPA

European SEPA equivalent for non-Swiss IBANs.

Split PDF by Swiss QR

Split a multi-invoice PDF by detecting QR-bill separator pages.