Passa al contenuto principale
PDF4me APIIntegrazioniBase di conoscenzaEstensioniTester APIBlog

Crea fattura SwissQR in Make

Cosa fa questo modulo

PDF4me Crea fattura SwissQR aggiunge un conforme svizzero QR ricevuta di pagamento della bolletta a un conto esistente PDF documento. Aggiunge la sezione standardizzata completa richiesta dagli standard di pagamento svizzeri (ISO 20022) per la fatturazione in Svizzera e Liechtenstein. Fornisci la tua fattura PDF, i dettagli del creditore e del debitore, IBAN, importo e riferimento, e il modulo restituisce lo stesso documento con la distinta di pagamento allegata. Tutte le banche svizzere accettano l'output per l'avvio del pagamento tramite l'app di mobile banking.

Articoli correlati del blog(2)
Word, fattura QR svizzera e un PDF di base. Uniscili in un unico documento. Sei moduli, fatto!
Scenario di creazione: Scarica il documento Word da Dropbox, convertilo in PDF con PDF4me, crea una fattura SwissQR, scarica il PDF di base, unisci le sovrapposizioni PDF, carica il documento. Procedura dettagliata con screenshot e meta tag per le immagini.
Leggi il post →
Aggiungere un codice QR svizzero a qualsiasi fattura PDF in Make: un flusso di lavoro Dropbox in 3 moduli
Scenario di creazione a tre moduli: Scarica un file da Dropbox, poi crea una fattura con codice QR svizzero tramite PDF4me e infine carica un file da Dropbox. Aggiunge una pagina con codice QR conforme agli standard di pagamento svizzeri a qualsiasi PDF di fattura, completa di tutti i campi relativi a creditore, debitore, IBAN e riferimento. Screenshot reali, valori esatti dei campi.
Leggi il post →

Autenticazione del tuo API Richiesta​

Ogni PDF4me modulo in Make richiede un valido Connessione. Crea o selezionane uno che contenga il tuo PDF4me API chiave in modo che lo scenario possa autenticare Swiss QR Generazione sicura delle fatture.

Get your API Key

Informazioni importanti da non perdere​

Aggiunge una ricevuta di pagamento al tuo conto esistente PDF e non crea un'immagine autonoma
A differenza di Crea codice a barre, che restituisce un Base64 immagine, questo modulo modifica il tuo documento sorgente aggiungendo l'intero Swiss QR sezione del disegno di legge con un QR codice e campi di pagamento leggibili dall'uomo direttamente al PDFInserisci il tuo modello di fattura e otterrai una fattura svizzera pronta per l'invio, completa di bollettino di pagamento.
I tipi di indirizzo S e K richiedono campi diversi
Sia il creditore che il debitore finale hanno un campo Tipo di indirizzo: S (strutturato) o K (combinato). Con S, compilare separatamente PostalCode E City campi. Con K, usa i due AddressLine I campi consentono di inserire l'indirizzo completo come testo libero. Il tipo scelto determina quali campi dell'indirizzo vengono convalidati, quindi compila solo i campi corrispondenti al tipo selezionato.
IBAN deve essere svizzero o del Liechtenstein e la valuta è CHF O EUR soltanto
Il suggerimento del modulo indica che IBAN deve iniziare con CH o LI, con un massimo di 21 caratteri. La valuta è strettamente limitata a CHF O EURPer l'Europa SEPA pagamenti con paesi non svizzeri IBANs, usa Genera EPC QR Codice per SEPA Invece.

Parametri​

Il modulo espone 26 campi raggruppati in quattro blocchi logici: connessione + file sorgente, elementi essenziali del pagamento, blocco dei creditori, blocco debitore, E riferimento di pagamento. Gli screenshot seguenti rispecchiano l'ordine esatto dei campi nel Make UI.

Obbligatorio (asterisco rosso nel UI): Connessione, Tipo di formato, Opzioni di impaginazione, Valuta, Tipo di riferimento, Lingua, Riga di separazione, Importo, IBAN, Tipo di indirizzo del creditore, Nome del creditore, Debitore finale AddressType. Condizionale: Nome file + documento quando il file è impostato su Map; Numero di pagina solo quando le Opzioni di impaginazione sono impostate su Personalizzato (numero di pagina). Opzionale: tutti i restanti campi dell'indirizzo del creditore/debitore più Riferimento, Messaggio non strutturato, Informazioni di fatturazione e AV1/AV2 Parametri.

Make Create SwissQR Bill module: Block 1: Connection, Format Type, File source, Paging Options, Currency
Block 1: Connection, Format Type, File source, Paging Options, Currency
Make Create SwissQR Bill module: Block 2: Reference Type, Language, Separator Line, Amount, IBAN
Block 2: Reference Type, Language, Separator Line, Amount, IBAN
Make Create SwissQR Bill module: Block 3: Creditor Address Type, Name, AddressLine1 and 2, PostalCode
Block 3: Creditor Address Type, Name, AddressLine1 and 2, PostalCode
Make Create SwissQR Bill module: Block 4: Creditor City, Ultimate Debtor AddressType, Name, AddressLine1 and 2
Block 4: Creditor City, Ultimate Debtor AddressType, Name, AddressLine1 and 2
Make Create SwissQR Bill module: Block 5: Ultimate Debtor PostalCode and City, Reference, Unstructured Message, Billing Info, AV1 Parameters
Block 5: Ultimate Debtor PostalCode and City, Reference, Unstructured Message, Billing Info, AV1 Parameters
ParametroNecessarioCosa faEsempio
ConnectionYesPDF4me connection. Click Add and paste your API key the first time, then reuse the connection across every PDF4me module.test prod account
Format TypeYesOutput container format. PDF for printable invoices and email attachments; PNG, JPEG, or TIFF for image output (no Paging Options applies in image modes). Empty falls back to the connector default. See the dropdown reference card below.PDF
FileConditionalHow the source PDF arrives. Radio: Dropbox - Download a File (or any other storage module), PDF4me Dev - Create Swiss QR Bill (chain from a prior PDF4me action), or Map (bind File Name and Document from a prior module manually). Skip the source file entirely for a standalone payment slip.Map
File NameConditionalFilename of the source PDF including .pdf extension. Required when File is set to Map. Mapped from the prior module File Name output.1. File Name
DocumentConditionalBinary content of the source PDF. Required when File is set to Map. Mapped from the prior module Data / binary output.1. Data
Paging OptionsYesWhere the Swiss QR-bill page is inserted (PDF Format Type only). Options: Empty (default), First (new page 1), Last (appended), Add page at the end (alias for Last), Custom (page number) (insert at the page number you supply in the Page Number field). See the dropdown reference card below.Custom (page number)
Page NumberConditionalThe 1-based page number where the Swiss QR-bill is inserted. Required when Paging Options is Custom (page number); ignored for every other Paging Options value. Page indexing starts at 1.3
CurrencyYesPayment currency. Only CHF and EUR are permitted by the Swiss Payment Standards.CHF
Reference TypeYesFormat of the payment reference. QRR (Swiss QR Reference, 27-digit numeric, used with QR-IBAN), SCOR (ISO 11649 creditor reference), NON (no reference).QRR
LanguageYesLanguage for the printed QR-bill text (Payment part labels: Account / Payable to, Reference, Currency, Amount). German, French, Italian, English.English
Separator LineYesSeparator line style displayed in the QR-bill section. Line With Scissor (line + scissor pictogram, standard print), Only Line (line, no pictogram), or No Line (eBill / e-invoice). Note: the Make UI labels the field "Seperator Line" (the engine accepts either spelling.Line With Scissor
AmountYesPayment amount in two decimal places without leading zeroes. Use the locale decimal separator your Culture & Language Settings expect.35345436
IBANYesIBAN 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
Creditor Address TypeYesAddress format for the creditor: S (Structured, separate PostalCode and City fields) or K (Combined, two free-text AddressLine fields).S
Creditor NameYesCreditor name or company according to the bank account. Maximum 70 characters.Var Schneider AG
Creditor AddressLine1NoCreditor primary address line. Maximum 70 characters.Var Schneider AG
Creditor AddressLine2NoCreditor secondary address line. 16 characters when address type is S; 70 characters when type is K.23
Creditor PostalCodeNoCreditor postal code. Maximum 16 characters.2501
Creditor CityNoCreditor town or city. Maximum 35 characters.biel
Ultimate Debtor AddressTypeYesAddress format for the debtor: S (Structured) or K (Combined). Same rules as Creditor Address Type.S
Ultimate Debtor NameNoDebtor name or company according to the bank account. Maximum 70 characters.Pia-Maria Rutschmann-Schnyder
Ultimate Debtor AddressLine1NoDebtor primary address line. Maximum 70 characters.Grosse Marktgasse
Ultimate Debtor AddressLine2NoDebtor secondary address line. 16 characters (S) or 70 characters (K).32
Ultimate Debtor PostalCodeNoDebtor postal code. Maximum 16 characters.9400
Ultimate Debtor CityNoDebtor town or city. Maximum 35 characters.Rorschach
ReferenceNoPayment reference number. Maximum 27 characters. Format depends on Reference Type (QRR: 27-digit numeric with mod-10 check; SCOR: ISO 11649; NON: leave empty).210000000003139471430009017
Unstructured MessageNoFree-text payment description shown in the Additional information block. Maximum 140 characters.Instruction of 15.09.2019
Billing InfoNoStructured 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 ParametersNoAlternative scheme parameter 1 (e.g. eBill identifier). Maximum 100 characters. Convention: "Name AV1: UV;…".Name AV1: UV;UltraPay005;12345
AV2 ParametersNoAlternative scheme parameter 2. Maximum 100 characters. Same convention as AV1 when a second alternative scheme is required.Name AV2: XY;Service002;67890

Opzioni del tipo di formato​

IL Make UI espone 5 valori. Scegli PDF per fatture stampabili e allegati e-mail; i formati immagine sono utili quando si incorpora il QR scivolare in un modello PDF in seguito o visualizzarlo direttamente nel corpo di un'e-mail.

PDF
Standard. Hybrid PDF/A-compatible page appended to the source invoice. Use with the Paging Options field below to choose where the slip lands.
PNG
Raster image of the QR-bill slip alone. Useful for inline email images or web previews.
JPEG
Compressed raster output. Slightly smaller than PNG; the QR code stays scannable.
TIFF
Lossless raster archive format. Best when the recipient needs print-grade quality.
Empty
No value set; the connector falls back to its default (PDF).

Riferimento alle opzioni di impaginazione​

Si applica solo quando il tipo di formato è PDF. Tipi di formato immagine (PNG, JPEG, TIFFIgnora le Opzioni di impaginazione perché non è presente alcun documento multipagina in cui inserirlo.

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 page at the end
Functional alias for Last. Picks whichever phrasing matches your downstream documentation.
Custom (page number)
Insert the QR-bill at a specific 1-based page index. Requires the Page Number field to be filled with the desired index (e.g. 3 inserts the slip as the new page 3).
Empty
No value set; the connector falls back to its default (First).

Configurazione rapida​

  1. Aggiungere PDF4me A Crea fattura SwissQR nel tuo Make scenario.
  2. Seleziona Connessione (oppure fai clic) Aggiungere per crearne uno con il tuo API chiave).
  3. Impostato Tipo di formato A PDF (O PNG / JPEG / TIFF per l'output dell'immagine). Imposta Opzioni di paginazione A First, Last, Add page at the end, O Custom (page number)Se scegli Personalizzato (numero di pagina), riempire anche Numero di pagina con l'indice basato su 1 dove dovrebbe atterrare lo slip (ad esempio 3).
  4. Impostato File a un modulo di archiviazione come Dropbox - Scarica un file, oppure scegli Map e legare Nome del file E Documento dal passaggio precedente. Saltare completamente il gruppo File per un'applicazione autonoma QR scontrino.
  5. Compila i campi di pagamento obbligatori con i valori riportati nelle schermate qui sopra: Valuta CHF O EUR), Tipo di riferimento QRR), Lingua English), Linea di separazione Line With Scissor), Quantità, IBAN (max 21 caratteri, CH o LI), Tipo di indirizzo del creditore S O K), Nome del creditore, E Debitore definitivo AddressType.
  6. Aggiungi i campi relativi all'indirizzo del creditore e del debitore, quindi, facoltativamente, compilali Riferimento, Messaggio non strutturato, Informazioni di fatturazione, E AV1 / AV2 Parametri per dati di pagamento più completi.
  7. Salva ed esegui. L'output del modulo Doc Data contiene la fonte PDF con gli svizzeri QR-pagina della fattura inserita nella posizione scelta al passaggio 3 (o una pagina autonoma) QR (scontrino quando non è stato fornito alcun file sorgente).

Esempi di flusso di lavoro​

Esempi di flusso di lavoroCommon Make scenario patterns using Create SwissQR Bill.
Automatizza la generazione di fatture svizzere da un foglio Google
  1. L'aggiunta di una nuova riga al registro delle fatture di Google Sheets attiva questo scenario.
  2. Google Drive scarica la fattura vuota PDF modello.
  3. Crea SwissQR Bill mappa tutti i campi di pagamento, incluso l'importo, IBANRiferimento e dettagli del creditore e del debitore, direttamente dalle colonne del foglio.
  4. Gmail invia la fattura completata con la Svizzera QR fattura allegata all'indirizzo email del cliente dal foglio.
Fatturazione mensile dell'abbonamento per i clienti svizzeri
  1. Un trigger programmato viene eseguito il primo giorno di ogni mese.
  2. Airtable restituisce tutti i record degli abbonamenti attivi.
  3. Un iteratore elabora ogni abbonato individualmente. La funzione "Crea fattura SwissQR" genera una fattura personalizzata con l'importo dell'abbonamento, i dettagli del cliente mappati come debitore finale e un riferimento univoco per ogni record.
  4. Gmail invia la fattura a ciascun cliente. Airtable viene aggiornato con la data e l'ora di invio.
Conti da riscuotere: allegare QR disegno di legge su ERP approvazione
  1. Un webhook si attiva quando una fattura viene approvata nel ERP sistema.
  2. HTTP scarica la fattura approvata PDF.
  3. Crea fattura SwissQR allega la ricevuta di pagamento utilizzando ERP-fornito IBAN, importo e numero di riferimento.
  4. La fattura completata viene caricata su SharePoint cartella dei crediti e il team contabile viene avvisato tramite Microsoft Teams.

Domande frequenti​

What does this module actually add to my PDF?+
It appends the complete Swiss QR bill payment slip section to your existing PDF. This is a standardized block containing the QR code with all encoded payment data, plus the human-readable payment fields (amount, IBAN, reference, creditor details). The output is a ready-to-send invoice accepted by Swiss banks for payment via mobile banking app.
What is the difference between Address Type S and K?+
S (Structured) means you fill separate PostalCode and City fields alongside AddressLine1 for the street. K (Combined) means you write the complete address across two free-text AddressLine fields with no separate city or postal code. Choose whichever matches how your data is structured, since both are valid under Swiss Payment Standards.
What Reference Type should I use?+
QRR (QR Reference) is the most common and uses a 27-character numeric string with a check digit for automated bank reconciliation in Switzerland. SCOR follows the international ISO 11649 creditor reference format. NON means no reference is included. Check with your bank which format your account supports for incoming payment matching.
Why is the IBAN restricted to CH or LI?+
Swiss QR bills are a payment standard specific to Switzerland and Liechtenstein. The module hint confirms: "Max 21 characters with CH or LI only." For SEPA payments across the EU and EEA using other country IBANs, use the Generate EPC QR Code for SEPA module instead.
What does the module return?+
Name (the output filename) and Doc Data (the binary PDF buffer of your source document with the Swiss QR bill section appended). Route Doc Data into Gmail as an attachment, upload it to Dropbox or Google Drive, or POST it to your ERP system.

Moduli correlati​

Richiedi assistenza​

Make IntegrationGet your API KeyMake Documentation