Criar suíço QR Conta em Zapier
O que esta ação faz
PDF4me Criar fatura SwissQR gera padrões de pagamento suíços (SPS) em conformidade suíço QR-contas (QR-Fatura) dentro do seu Zapier Fluxo de trabalho. Converta dados de faturas do Bexio, Sage, Abacus, QuickBooks, Xero, Microsoft Dynamics ou qualquer outro sistema. Zapier-fonte conectada em um formato suíço pronto para impressão QR-conta com IBAN, detalhes estruturados do credor e do devedor final, QR Referência (QRR) ou Referência do Credor (SCOR), Valor, Moeda e rótulos multilíngues. Saída como PDF, PNG, JPEG, ou TIFFAceito por todos os bancos suíços. PostFinancee aplicativo bancário suíço desde o QRA fatura tornou-se o único documento de pagamento válido na Suíça em 30 de setembro de 2022.
Autenticando seu API Solicitar
Para acessar o PDF4me Web API através ZapierToda ação precisa ser autenticada. Clique. Conecte uma nova conta Na primeira vez, cole o seu PDF4me API Chave. Os Zaps subsequentes reutilizam a conexão automaticamente.
Fatos importantes que você não deve perder
Configurar em Zapier
No Configurar Etapa, os campos aparecem na ordem abaixo. Tipo de formato, IBAN, Tipo de endereço do credor, e Nome do credor são obrigatórios (marcados com asterisco) Zapier); outros campos são opcionais ou condicionais.
Saída e PDF posicionamento: definir Tipo de formato (PDF/PNG/JPEG/TIFF), mapa opcional Arquivo ou Arquivo URL e Nome do arquivo, escolher Opções de paginação (aqui Personalizado (número da página) com Número da página 2), então Moeda e Tipo de referência (exemplo: CHF e QRR).
Pagamento e credor: Moeda, Tipo de referência, Quantia, IBANe estruturado Credor campos de endereço (S = Estruturado).
Campos de devedor, referência e avançados: opcional Devedor final detalhes, Referência (para QRR/SCOR), Mensagem não estruturada, Informações de faturamento (Swico), e AV1 / AV2 parâmetros.
Parâmetros
A ação Criar Fatura SwissQR expõe 26 campos, apresentados no Zapier UI como cinco blocos roláveis. As capturas de tela abaixo refletem a ordem exata dos campos e capturam os valores de exemplo verificados de uma execução real.





Requerido no Zapier UI (com asterisco): Tipo de formato, IBANTipo de endereço do credor, Nome do credor. Condicional: Arquivo ou Arquivo URL (ou um ou outro, usado ao incorporar) QR-conta em uma conta existente PDF); Número da página (quando a opção de paginação é Personalizada). Altamente recomendado para portadores de visto suíço válido. QR-contas: todos os campos de endereço do credor e do devedor final. A especificação dos Padrões de Pagamento Suíços exige dados de endereço completos, mesmo que o Zapier UI não os marca com asterisco.
| Parâmetro | Obrigatório | O que faz | Exemplo |
|---|---|---|---|
| Format Type | Yes | Output file format. PDF for print-ready Swiss QR-bills (default), PNG/JPEG for digital web or email embedding, TIFF for archival quality, Empty/null for raw data. Asterisked in the Zapier UI. | PDF |
| File | Conditional | Base PDF where the Swiss QR-bill will be embedded. Either provide File or File URL, not both. Map binary content from a previous step (Dropbox, Google Drive, HTTP). Hint: "Either provide File or File URL". | Input sample (sample.pdf)1. File |
| File URL | Conditional | Public URL to the base PDF. Either provide File or File URL. PDF4me downloads the file and embeds the QR-bill onto it. | Input sample (sample.pdf)1. File |
| File Name | No | Output filename for the generated Swiss QR-bill document. Include the extension matching Format Type (.pdf, .png, .jpg, .tiff). | Output sample (sample.swissqr.pdf) |
| paging Options | No | Controls where the QR-bill is placed in the output PDF. First (top of doc), Last (final page), Add Page At End (appends a new dedicated QR-bill page), Custom (specific page index; requires Page Number below). | Custom (page number) |
| Page Number | Conditional | Specific page index for the QR-bill placement. Required when paging Options is Custom. Page index starts at 1. | 3 |
| Currency | No | Currency for the QR-bill payment amount. Only CHF (Swiss Franc, default for Swiss domestic) and EUR (cross-border) are valid per SPS specification. | CHF |
| Reference Type | No | Sent as code: NON (No Reference, for simple payments), QRR (27-digit QR Reference for QR-IBAN auto-reconciliation), or SCOR (ISO 11649 Creditor Reference for SEPA-compatible cross-border). | QRR |
| Language Type | No | Display language for printed QR-bill labels. Options: English, German, French, Italian. Match the recipient's Swiss region. | English |
| Separator Line | No | Visual separator between invoice body and QR-bill tear-off section. Options: "Line with Scissor" (Swiss standard for printed bills), Simple Line, No Line. | Line with Scissor |
| Amount | No | Payment amount in the chosen Currency. Enter as a number with up to two decimal places. Leave blank if the customer fills in the amount themselves. | 19432 |
| IBAN | Yes | Creditor's Swiss IBAN. Must start with CH and have 19 digits total. For QRR reference type, use a QR-IBAN (with QR-IID 30000-31999). Asterisked in the Zapier UI. | CH4431999123000889012 |
| Creditor Address Type | Yes | Address format for creditor information. Sent as code S (Structured, recommended for Swiss banking) or K (Combined, two free-form lines). Asterisked. | S |
| Creditor Name | Yes | Full name of the creditor (company or individual) as registered with the bank. Printed on the generated QR-bill. Asterisked. | muneer |
| Creditor: Street Name or Address Line 1 | No | Street name for the creditor (Structured) OR first free-form address line (Combined). Strongly recommended for valid SPS output. | vb vcb |
| Creditor: Building Number or Address Line 2 | No | House/building number (Structured) OR second free-form address line (Combined). | 1268 |
| Creditor City | No | Swiss city for the creditor. Must correspond to the Postal Code. | Zurich |
| Creditor Postal Code | No | Valid 4-digit Swiss postal code for the creditor. | 2501 |
| Ultimate Debtor Address Type | No | Address format for the party who will pay the bill. S (Structured) or K (Combined). Use S for automated processing. | S |
| Ultimate Debtor Name | No | Full name of the party who will pay. Appears in the payment section of the printed QR-bill. | Pia-Maria Rutschmann-Schnyder |
| Ultimate Debtor: Street Name or Address Line 1 | No | Debtor street name (Structured) or first free-form line (Combined). | Grosse Marktgasse |
| Ultimate Debtor: Building Number or Address Line 2 | No | Debtor house/building number or secondary address line. | 23 |
| Ultimate Debtor City | No | Swiss city of the debtor. | Rorschach |
| Ultimate Debtor Postal Code | No | Valid 4-digit Swiss postal code for the debtor. | 9400 |
| Reference | No | The actual reference value embedded in the QR code. Required content when Reference Type is QRR (27-digit numeric) or SCOR (ISO 11649 starting with RF). Empty when Reference Type is NON. | 210000000003139471430009017 |
| Unstructured Message | No | Free-form payment note printed on the QR-bill. Combined with Billing Info, max 140 characters total. Useful for invoice references when Reference Type is NON. | Instruction of 15.09.2019 |
| Billing Info | No | Structured billing information per Swiss QR-bill specification (Swico syntax). Encodes invoice number, date, VAT details. Combined with Unstructured Message, max 140 characters total. | S1/01/20170309/11/10201409/20/14000000/22/36958/30/CH106071086/40/1020/41/3010 |
| AV1 Parameters | No | Alternative procedure parameter 1 (AV1). Reserved for future Swiss payment alternative procedures and bilateral agreements between sender and receiver. | Name AV1: UV;UltraPay005;12345 |
| AV2 Parameters | No | Alternative procedure parameter 2 (AV2). Reserved for future Swiss payment alternative procedures. | Name AV2: XY;XYService;54321 |
Opções de tipo de formato
Controla o formato do arquivo de saída do Swiss gerado. QR-conta.
PDFPadrão (pronto para impressão)PNGIncorporação web e digitalJPEGImagem compactada adequada para envio por e-mailTIFFQualidade de arquivoVazio (nulo)Saída de dados brutosOpções de tipo de referência
Controla qual padrão de referência de pagamento está incorporado no QR código. Isso afeta diretamente a forma como os pagamentos são conciliados no extrato bancário do destinatário.
NÃOSem referência (pagamentos simples)QRRQR Referência (conciliação suíça de 27 dígitos)PONTUAÇÃOReferência do credor (ISO 11649 SEPA)Opções de tipo de endereço
Aplica-se a ambos. Tipo de endereço do credor e Tipo de endereço do devedor final.
SEstruturado (recomendado)KCombinadas (duas linhas de forma livre)Opções de paginação
Controles onde o QR-a conta é colocada na saída PDF quando o tipo de formato for PDF.
PrimeiroDurarAdicionar página no finalPersonalizado (número da página)Arquivos de exemplo
Use esses arquivos para testar Criar fatura SwissQR antes de conectar seu Zap energizado. sample.pdf é o entrada: uma planície PDF você mapeia para Arquivo (ou anfitrião em Arquivo URL). sample.swissqr.pdf é o saída: o mesmo documento depois PDF4me acrescenta o suíço QR-Seção de pagamento de contas com suas configurações IBANcampos de credor e de referência.
exemplo.pdfsample.swissqr.pdfCampos de saída
| Campo | Tipo | O que contém |
|---|---|---|
File Content | Binary | Generated Swiss QR-bill file (PDF/PNG/JPEG/TIFF). Map into the next step for upload, email, or further processing. See sample.swissqr.pdf for a PDF example. |
File Url | String | Direct URL to access the generated QR-bill, useful for sharing or downstream HTTP processing. |
File Name | String | Output filename without extension (for example sample.swissqr when the full name is sample.swissqr.pdf). |
Full File Name | String | Complete output filename with extension matching the chosen Format Type (for example sample.swissqr.pdf). |
Configuração rápida
- Em Zapier, clique + para adicionar uma nova ação e selecionar PDF4me.
- Escolher Criar fatura SwissQR como o evento de ação.
- Conecte seu PDF4me conta ou cole sua API Digite a tecla quando solicitado.
- Definir Tipo de formato: PDF para faturas impressas, PNG/JPEG para web/e-mail, TIFF para fins de arquivo.
- Se incorporar o QR-conta em uma conta existente PDFmapa Arquivo OU Arquivo URL (não ambos) e escolha Opções de paginação (Personalizado requer Número da página).
- Digitar Moeda (
CHFpara uso doméstico suíço,EUR(para fins transfronteiriços), Quantia, Tipo de referência (QRR/SCOR/NON), Tipo de idioma, e Linha Separadora. - Digitar IBAN (Crédito suíço válido) IBAN; para QRR tipo de referência use um QR-IBAN com QR-IID 30000: 31999).
- Preencha tudo Credor Campos: Nome, Tipo de endereço (S recomendado), Nome da rua, Número do prédio, Cidade, CEP.
- Preencher Devedor final Campos com os dados da parte pagadora (mesmo padrão Estruturado/Combinado).
- Para casos avançados, adicione Referência (27 dígitos) QRR ou RF... SCOR), Mensagem não estruturada, Informações de faturamento (Sintaxe Swico), AV1, AV2.
- Teste a ação com dados de amostra, verifique a saída e ative o Zap.
Exemplos de fluxo de trabalho
Exemplos de fluxo de trabalhoCommon Zapier workflow patterns using Create SwissQR Bill.
- Um webhook do Bexio, Sage ou Abacus é acionado quando uma nova fatura B2B é finalizada para um cliente suíço.
- PDF4me Criar execução de fatura SwissQR: Tipo de formato = PDF, Moeda = CHF, Tipo de referência = QRR (com QR-IBAN), Tipo de idioma = Alemão, Quantidade e IBAN mapeado a partir da carga útil do webhook.
- Os campos de credor são mapeados a partir do registro da sua empresa; os campos de devedor final são mapeados a partir do registro do cliente no sistema de origem.
- Um Gmail ou Outlook O passo envia o QR-conta PDF como anexo de e-mail na mensagem de cobrança do cliente. O arquivo está totalmente SPS-Compatível e pronto para pagamento instantâneo a partir de qualquer aplicativo bancário suíço.
- Um registro no Google Sheets ou no Airtable captura o ID da fatura, o cliente e o valor. QR Referência e registro de data e hora para conciliação de contas a receber.
- Um webhook de finalização de compra do Shopify, WooCommerce ou Stripe é acionado quando um cliente suíço escolhe "Pagar por transferência bancária" em vez de cartão.
- PDF4me Criar execução de fatura SwissQR: Tipo de formato = PNG (incorporação de imagem), Moeda = CHF, Tipo de referência = QRRValor total do pedido, idioma correspondente à localidade do cliente.
- O PNG A imagem está incorporada diretamente em um HTML E-mail de confirmação do pedido para que o cliente possa digitalizá-lo diretamente no aplicativo do banco para efetuar o pagamento.
- Pagamento recebido → conciliação bancária confere QR Retorna automaticamente ao pedido original.
- O pedido na Shopify é marcado como Pago e o processamento do pedido é iniciado sem necessidade de conciliação manual ou tentativa de adivinhar o número da fatura.
- Um cronograma por Zapier O gatilho é acionado no dia 1º de cada mês para cobrança da assinatura mensal. CHF.
- Uma pesquisa no Google Sheets ou no Airtable recupera todos os assinantes ativos com seus respectivos nomes. IBAN, endereço, valor e QR Modelo de referência.
- Um Loop por Zapier itera sobre cada assinante. PDF4me A criação de uma fatura SwissQR gera uma QR-conta por linha com QRR Referência e paginação "Adicionar página ao final".
- Cada QR-conta PDF é enviado por e-mail ao assinante via Gmail e arquivado na Microsoft. SharePoint com um padrão de nome de arquivo como
qrbill_{customerId}_{YYYY-MM}.pdf. - Um e-mail mensal de resumo para a equipe financeira apresenta o valor total faturado, o número de assinantes e o número de exceções, proporcionando uma visão clara do fluxo de caixa desde o primeiro dia.


