Criar fatura SwissQR em 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.

O que esta ação faz

PDF4me Código de barras - Criar fatura SwissQR Anexa um comprovante de pagamento com código QR compatível com os padrões de pagamento suíços a uma fatura. PDF dentro de um Power Automate fluxo, ou gera uma fatura QR independente apenas a partir dos dados de pagamento. Conteúdo do arquivo Pipe de SharePoint, OneDrive, Dropbox, Dataverse, ou Outlook anexos; fornecer IBAN + credor + devedor + campos de referência; selecione o formato de saída (PDF, PNG, JPEG, Tiff); e a ação retorna um arquivo que pode ser escaneado por um banco suíço, pronto para ações subsequentes como Criar arquivo, Enviar e-mail ou Mensagem do Teams. ISO 20022 Em conformidade; aceito por todos os aplicativos bancários suíços desde 2022.

Autenticando seu API Solicitar

O PDF4me Conecte o conector em Power Automate requer um válido conexão segurando o seu PDF4me API Chave. Crie a conexão uma vez durante o tempo de projeto do fluxo e, em seguida, a cada PDF4me A ação em seu inquilino a reutiliza.

Get your API Key

Fatos importantes que você não deve perder

Quatro formatos de saída, não apenas PDF

Tipo de formato de saída aceito PDF (híbrido, anexado à sua fatura original), PNG, JPEG, ou Tiff (imagens independentes do QR deslize). Use formatos de imagem para incorporação em e-mails ou pré-visualizações na web; use PDF Ao entregar uma fatura completa.

IBAN Deve ser CH ou LI, moeda CHF ou EUR

A especificação dos Padrões de Pagamento Suíços restringe IBAN para emissores suíços/liechtensteinenses (máximo de 21 caracteres) e moeda para CHF / EUR. Para QRR Tipo de referência IBAN deve ser um QR-IBAN, não é um padrão IBANPara outros europeus. IBANs Use a opção Gerar EPC. QR Código para SEPA em vez de.

As opções de paginação estão localizadas em Parâmetros avançados.

Clique Mostrar tudo em parâmetros avançados para expor Opções de paginação, Número da página, Conteúdo do arquivo, e Nome do arquivoDefina as opções de paginação para personalizado + Preencha o número da página para acessar o QR-conta em uma página específica (baseado em 1). Aplica-se somente quando o Tipo de Formato de Saída for PDF.

Parâmetros

A ação expõe o pagamento + credor + devedor + referência campos no painel principal e 4 campos abaixo Parâmetros avançados que controlam o arquivo de entrada e o posicionamento da página. As capturas de tela abaixo refletem a ordem exata dos campos no Power Automate Interface do usuário.

Obrigatório (asterisco vermelho na interface do usuário): IBAN, Quantia. Altamente recomendado para embalagens em conformidade com a norma SPS: Tipo de formato de saída, Nome do credor, Tipo de endereço do credor, Linhas de endereço + CEP + Cidade, Bloco do devedor final, Moeda, Tipo de referência, Tipo de idioma, Linha separadora. Condicional (Parâmetros avançados): Número da página quando as opções de paginação são personalizadoConteúdo do arquivo + Nome do arquivo ao anexar o QR deslizar para um existente PDF (Ignore ambos para uma versão independente) QR-escorregar).

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

Parâmetro	Obrigatório	O que faz	Exemplo
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`

Opções de tipo de formato de saída

No menu suspenso Tipo de formato de saída do Power Automate, o PNG está selecionado, com as opções JPEG, PDF, PNG e TIFF. — A lista suspensa Tipo de formato de saída apresenta 4 opções.

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.

Referência de opções de paginação (parâmetros avançados)

Aplica-se somente quando o Tipo de Formato de Saída for PDF. Os tipos de formato de imagem (PNG, JPEG, TIFF) ignoram as opções de paginação porque a saída é independente. QR Imagem deslizante, não um documento com várias páginas.

Os parâmetros avançados do Power Automate foram expandidos, mostrando o Número da Página 3, Opções de Paginação personalizadas, Conteúdo do Arquivo e campos para Nome do Arquivo. — Parâmetros avançados expandidos: Número da página 3, Opções de paginação personalizadas, Conteúdo do arquivo mapeado, Nome do arquivo 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).

Saída

Campo	Tipo	O que contém
`File Content`	Binário	Os suíços populosos QR- Saída da fatura no formato de saída escolhido. Passe para SharePoint Criar arquivo, OneDrive Criar arquivo, Outlook Envie um e-mail ou publique uma mensagem no Teams.
`File Name`	String	Nome do arquivo de saída, baseado no nome do arquivo de entrada (ou um valor padrão caso nenhum arquivo de origem tenha sido fornecido).

Arquivo de exemplo

Exemplo de fatura de 10 páginas

Utilize como fonte PDF Ao testar a ação de ponta a ponta, compare com os valores dos campos das capturas de tela acima.

Configuração rápida

Adicionar PDF4me para Código de barras - Criar fatura SwissQR em seu Power Automate fluxo.
Faça login no PDF4me Conectar conector com o seu API chave.
Definir Tipo de formato de saída para PDF (ou PNG / JPEG / Tiff para saída de imagem).
Preencha os campos de pagamento: IBAN (CH ou LI, máximo de 21 caracteres), Quantia, Moeda (CHF ou EUR), Tipo de referência (QRR, SCOR, ou NON), Tipo de idioma, Linha Separadora.
Preencha o Credor bloco (Nome, Tipo de Endereço, linhas de endereço, CEP, Cidade) e Devedor final bloquear.
Preencha opcionalmente Referência, Mensagem não estruturada, Informações de faturamento, Parâmetros AV1 / AV2.
Clique Mostrar tudo sobre Parâmetros avançadosMapa Conteúdo do arquivo e Nome do arquivo de uma ação anterior (SharePoint, OneDriveDropbox, Outlook). Definir Opções de paginação para first / last / add at end / custom. Se custom, preencher Número da página com o índice de página baseado em 1 onde o bilhete deve cair (por exemplo, 3).
Salve e execute. A ação retorna. Conteúdo do arquivo com o povoado PDF ou imagem. Conecte ao tubo. SharePoint Criar arquivo, OneDrive Criar arquivo, Outlook Envie um e-mail ou publique uma mensagem no Teams.

Exemplos de fluxo

Padrões de fluxo comuns do Power AutomateThree ways to chain Create SwissQR Bill into a flow.

SharePoint Biblioteca de faturas para enviar por e-mail

SharePoint Quando um arquivo é criado O gatilho é acionado em /Documentos/Faturas.
SharePoint Obter o conteúdo do arquivo carrega o PDF binário.
O recurso Criar Fatura SwissQR anexa o comprovante de pagamento (Tipo de Formato de Saída) PDF, Opções de paginação por último).
Outlook Enviar um e-mail anexando os dados preenchidos PDF ao cliente.

fluxo de trabalho de arquivamento do Dropbox

Acione um fluxo manualmente (ou o Dropbox quando um arquivo for criado).
Dropbox Obter conteúdo de arquivo usando leituras de caminho /pdf4metest/sample/10 page.pdf.
A criação de fatura SwissQR anexa ao comprovante as opções de paginação. personalizado, Número da página 3.
O Dropbox cria gravações de arquivos em /pdf4meoutput com um nome de arquivo exclusivo criado a partir de guid() + o nome da fonte.

Independente QR deslize dos dados do Dataverse

O gatilho de recorrência é acionado diariamente.
A função "Listar linhas" do Dataverse retorna faturas vencidas.
Aplicar a cada um: Criar fatura SwissQR sem Conteúdo do arquivo (ignore os campos de arquivo avançados) usando os dados de pagamento da linha. Tipo de formato de saída PNG.
Outlook O envio de um e-mail incorpora o QR PNG em conjunto com um lembrete de pagamento.

Perguntas frequentes

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.