Creare svizzero QR Bill in Zapier
Cosa fa questa azione
PDF4me Crea fattura SwissQR genera gli standard di pagamento svizzeri (SPS) conforme svizzero QR-fatture (QR-Fattura) dentro il tuo Zapier flusso di lavoro. Converti i dati delle fatture da Bexio, Sage, Abacus, QuickBooks, Xero, Microsoft Dynamics o qualsiasi altro Zapier-connessione della sorgente in un file svizzero pronto per la stampa QR-fattura con IBAN, dettagli strutturati del creditore e del debitore finale, QR Riferimento (QRR) o Riferimento del creditore (SCOR), Importo, Valuta ed etichette multilingue. Output come PDF, PNG, JPEG, O TIFFAccettato da tutte le banche svizzere, PostFinancee app bancaria svizzera dal QRLa fattura è diventata l'unico documento di pagamento svizzero valido a partire dal 30 settembre 2022.
Articoli correlati del blog(2)
Autenticazione del tuo API Richiesta
Per accedere al PDF4me Web API Attraverso Zapier, ogni azione deve essere autenticata. Clicca Collega un nuovo account la prima volta e incolla il tuo PDF4me API Chiave. Gli Zap successivi riutilizzano automaticamente la connessione.
Informazioni importanti da non perdere
svizzero QR-La fattura è l'UNICO documento di pagamento svizzero valido dal 30 settembre 2022
Le vecchie ricevute di pagamento rosse (ES) e arancioni (ESR) sono state eliminate dal Gruppo SIX e dalle banche svizzere. Ogni fattura B2B e B2C svizzera ora richiede un documento svizzero. QR-fattura per pagamento nazionale. Zapier l'azione produce completamente SPS-output conforme accettato da tutte le banche svizzere e PostFinance.
QRR vs SCOR vs NON: scegli il tipo di riferimento corretto
Utilizzo QRR (27 cifre QR Riferimento) con un QR-IBAN per la riconciliazione bancaria automatizzata svizzera. Utilizzare SCOR ISO 11649 Riferimento del creditore) per SEPA Fatturazione transfrontaliera. Utilizzare NON Per pagamenti semplici senza riferimento strutturato. Abbina a Messaggio non strutturato per il contesto.
L'indirizzo strutturato (S) è necessario per la riconciliazione automatizzata
Entrambi i tipi di indirizzo Creditore e Debitore finale accettano S (Strutturato: campi separati per via, numero civico, codice postale e città) o K (Combinate: due linee a forma libera). Utilizzare S per i flussi di lavoro di produzione bancaria svizzeri; K è consentito ma con minore precisione per l'elaborazione automatizzata a valle.
Configura in Zapier
Sul Specificare passaggio, i campi appaiono nell'ordine seguente. Tipo di formato, IBAN, Tipo di indirizzo del creditore, E Nome del creditore sono richiesti (contrassegnati con un asterisco in Zapier); gli altri campi sono facoltativi o condizionali.
Uscita e PDF Posizionamento: impostato Tipo di formato PDF/PNG/JPEG/TIFF), mappa facoltativa File O File URL E Nome del file, scegliere Opzioni di paginazione (Qui Personalizzato (numero di pagina) con Numero di pagina 2), Poi Valuta E Tipo di riferimento (esempio: CHF E QRR).
Pagamento e creditore: Valuta, Tipo di riferimento, Quantità, IBANe strutturato Creditore campi indirizzo (S = Strutturato).
Debitore, referenza e campi avanzati: arancione Debitore definitivo dettagli, Riferimento (per QRR/SCOR), Messaggio non strutturato, Informazioni di fatturazione (Swico) e AV1 / AV2 parametri.
Parametri
L'azione Crea fattura SwissQR espone 26 campi, presentati nel Zapier UI come cinque blocchi scorrevoli. Gli screenshot seguenti rispecchiano l'ordine esatto dei campi e mostrano i valori di esempio verificati da un'esecuzione reale.
Richiesto nel Zapier UI (contrassegnato da un asterisco): Tipo di formato, IBANTipo di indirizzo del creditore, Nome del creditore. Condizionale: File o file URL (o l'uno o l'altro, utilizzato quando si incorpora QR-fattura in un documento esistente PDF); Numero di pagina (quando le opzioni di impaginazione sono personalizzate). Fortemente consigliato per i possessori di patente svizzera valida QR-fatture: tutti i campi dell'indirizzo del creditore e i campi del debitore finale. La specifica degli standard di pagamento svizzeri richiede dati di indirizzo completi anche se Zapier UI non li contrassegna con un asterisco.
| Parametro | Necessario | Cosa fa | Esempio |
|---|---|---|---|
| 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 |
Opzioni del tipo di formato
Controlla il formato del file di output del file svizzero generato QR-conto.
PDFPredefinito (pronto per la stampa)Fedeltà completa svizzera QR-conto PDF Pronto per la stampa, la spedizione o l'archiviazione. Lo standard per la fatturazione svizzera B2B e B2C.
PNGIntegrazione web e digitaleQR-fattura come PNG immagine. Incorpora nei portali clienti, fatture web, app mobili o HTML email in cui è richiesto un formato immagine.
JPEGImmagine compressa adatta alla posta elettronicaDimensioni del file inferiori a PNGIdeale per l'incorporamento in linea nelle email o per la distribuzione su dispositivi mobili, dove la larghezza di banda è più importante della fedeltà perfetta.
TIFFQualità da archivioAlta risoluzione TIFF per sistemi di gestione documentale, archiviazione bancaria e flussi di lavoro di conservazione normativa che richiedono la massima fedeltà dell'immagine.
Vuoto (nullo)output dei dati grezziCrudo QR-dati di fatturazione senza un wrapper di file specifico. Da utilizzare per il flusso a valle API integrazioni che gestiscono autonomamente la conversione del formato.
Opzioni del tipo di riferimento
Controlla quale standard di riferimento di pagamento è incorporato nel QR codice. Ciò influisce direttamente sul modo in cui i pagamenti vengono riconciliati nell'estratto conto bancario del beneficiario.
NONNessun riferimento (pagamenti semplici)Nessun riferimento strutturato incorporato. Da utilizzare per pagamenti una tantum in cui la riconciliazione viene gestita manualmente o tramite il campo Messaggio non strutturato. Compatibile con CH- standardIBANs (non QR-IBANs).
QRRQR Riferimento (riconciliazione svizzera a 27 cifre)Riferimento numerico a 27 cifre (sostituisce il vecchio ESR). Obbligatorio quando si utilizza un QR-IBAN (contenente QR-IID 30000-31999). Consente la riconciliazione dei pagamenti completamente automatizzata con PostFinance e tutte le banche svizzere. La scelta standard per la fatturazione B2B nazionale su larga scala.
SCORRiferimento del creditore (ISO 11649 SEPA)ISO 11649 Riferimento del creditore strutturato che inizia con RF + due cifre di controllo + fino a 21 caratteri alfanumerici. Da utilizzare per transazioni transfrontaliere. SEPA-fatturazione compatibile o quando il tuo sistema contabile richiede standardizzazione ISO riferimenti.
Opzioni del tipo di indirizzo
Si applica a entrambi Tipo di indirizzo del creditore E Tipo di indirizzo del debitore finale.
SStrutturato (consigliato)Ogni componente dell'indirizzo viene memorizzato in un campo separato (Via, Numero civico, Codice postale, Città). Richiesto dalla maggior parte dei sistemi bancari svizzeri per la riconciliazione automatica dei pagamenti. Obbligatorio per QR-IBAN elaborazione.
KCombinate (due linee libere)Indirizzo completo su due righe a formato libero. Più semplice da compilare, ma meno preciso per l'elaborazione automatizzata successiva. Da utilizzare solo quando l'indirizzo strutturato non è fattibile a causa di fonti di dati di indirizzo obsolete.
Opzioni di paginazione
Controlli dove il QR-la fattura viene inserita nell'output PDF quando il tipo di formato è PDF.
PrimoI posti il QR- fattura sulla prima pagina del documento di output.
ScorsoI posti il QR- fattura sull'ultima pagina del documento esistente.
Aggiungi pagina alla fineL'opzione più comune. Aggiunge una nuova pagina dedicata con il QR-fattura. Mantiene inalterato tutto il contenuto della fattura.
Personalizzato (numero di pagina)Indice di pagina specifico dal campo Numero di pagina. Da utilizzare quando il modello di fattura riserva una pagina specifica per la QR-conto.
File di esempio
Utilizza questi file per testare Crea fattura SwissQR prima di collegare il tuo Zap attivo. sample.pdf è il ingresso: una semplice PDF mappare a File (o ospitare a File URL). sample.swissqr.pdf è il produzione: lo stesso documento dopo PDF4me aggiunge lo svizzero QR-sezione di pagamento delle bollette con la tua configurazione IBANcampi relativi al creditore e al riferimento.
Ingresso
esempio.pdf
Fattura base PDF senza un QR-fattura. Mappa questo file su File Quando Tipo di formato È PDF e desideri incorporare la ricevuta di pagamento in un documento esistente.
esempio.pdfProduzione
esempio.swissqr.pdf
Risultato dopo l'esecuzione dell'azione: contenuto della fattura più un documento svizzero QR-sezione del disegno di legge (QR codice, IBAN(blocchi importo, creditore e debitore). Confronta con il file di input per vedere cosa ha aggiunto il modulo.
esempio.swissqr.pdfCampi di output
| Campo | Tipo | Cosa contiene |
|---|---|---|
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). |
Configurazione rapida
- In Zapier, clicca + per aggiungere una nuova azione e seleziona PDF4me.
- Scegliere Crea fattura SwissQR come evento di azione.
- Collega il tuo PDF4me account o incolla il tuo API tasto quando richiesto.
- Impostato Tipo di formato: PDF per fatture stampate, PNG/JPEG per web/e-mail, TIFF per l'archiviazione.
- Se si incorpora il QR-fattura in un documento esistente PDFmappa File O File URL (non entrambi) e scegliere Opzioni di paginazione (richiede la dogana Numero di pagina).
- Inserisci Valuta
CHFper la Svizzera nazionale,EURper le transazioni transfrontaliere), Quantità, Tipo di riferimentoQRR/SCOR/NON), Tipo di lingua, E Linea di separazione. - Inserisci IBAN (valido CH svizzero) IBAN; per QRR tipo di riferimento usa un QR-IBAN con QR-IID 30000: 31999).
- Compilare tutto Creditore Campi: Nome, Tipo di indirizzo (S consigliato), Nome della via, Numero civico, Città, Codice postale.
- Riempire Debitore definitivo campi con i dettagli del pagatore (stesso modello Strutturato/Combinato).
- Per i casi avanzati, aggiungere Riferimento (27 cifre QRR o RF... SCOR), Messaggio non strutturato, Informazioni di fatturazione (Sintassi Swico), AV1, AV2.
- Esegui un test con dati di esempio, verifica il risultato e attiva lo Zap.
Esempi di flusso di lavoro
Esempi di flusso di lavoroCommon Zapier workflow patterns using Create SwissQR Bill.
Fattura Bexio / Sage → Svizzera QR-fattura → invia email al cliente
- Un webhook di Bexio, Sage o Abacus si attiva quando viene finalizzata una nuova fattura B2B per un cliente svizzero.
- PDF4me Crea fatture SwissQR: Tipo di formato = PDF, Valuta = CHF, Tipo di riferimento = QRR (con QR-IBAN), Tipo di lingua = tedesco, Quantità e IBAN mappato dal payload del webhook.
- I campi relativi al creditore vengono mappati dai dati aziendali; i campi relativi al debitore finale vengono invece mappati dai dati del cliente nel sistema di origine.
- Un Gmail o Outlook il passaggio invia il QR-conto PDF come allegato e-mail all'e-mail di fatturazione del cliente. Il file è completamente SPS-Conforme e pronto per i pagamenti istantanei da qualsiasi app bancaria svizzera.
- Un registro di Google Sheets o Airtable acquisisce l'ID della fattura, il cliente, l'importo, QR Riferimento e data/ora per la riconciliazione dei crediti.
Ordine svizzero di e-commerce → QR-conto PNG → email di checkout
- Un webhook di Shopify, WooCommerce o Stripe si attiva quando un cliente svizzero sceglie "Paga tramite bonifico bancario" anziché con carta di credito.
- PDF4me Crea fatture SwissQR: Tipo di formato = PNG (incorporamento dell'immagine), Valuta = CHF, Tipo di riferimento = QRRImporto dal totale dell'ordine, tipo di lingua corrispondente alle impostazioni locali del cliente.
- IL PNG l'immagine è incorporata in linea in un HTML e-mail di conferma dell'ordine in modo che il cliente possa scansionarla direttamente nella propria app bancaria per effettuare il pagamento.
- Pagamento ricevuto → la riconciliazione bancaria corrisponde QR Riferimento automatico all'ordine originale.
- L'ordine Shopify viene contrassegnato come pagato e l'evasione inizia senza alcuna riconciliazione manuale o tentativo di indovinare il numero di fattura.
Pacchetto di abbonamento mensile → QR-proposte → archivio in SharePoint
- Un programma di Zapier il trigger scatta il 1° di ogni mese per la fatturazione dell'abbonamento mensile in CHF.
- Una ricerca su Google Sheets o Airtable recupera tutti gli abbonati attivi con il loro IBAN, indirizzo, importo e QR Modello di riferimento.
- Un ciclo di Zapier itera su ciascun abbonato. PDF4me Crea una fattura SwissQR genera un QR-fattura per riga con QRR Riferimento e paginazione Aggiungi pagina alla fine.
- Ogni QR-conto PDF viene inviato via email all'abbonato tramite Gmail e archiviato in Microsoft SharePoint con un modello di nome file come
qrbill_{customerId}_{YYYY-MM}.pdf. - Un'e-mail riepilogativa mensile inviata al team finanziario riporta l'importo totale fatturato, il numero di abbonati e il numero di eccezioni, garantendo una chiara visibilità del flusso di cassa fin dal primo giorno.
Domande frequenti
Azioni correlate
Leggi il codice SwissQR
Estrarre i dati di pagamento strutturati (IBAN, importo, creditore, riferimento) da entrate svizzere QR-fatture. Da utilizzare per l'automazione della contabilità fornitori e l'acquisizione delle fatture dei fornitori.
Diviso PDF di Swiss QR
Suddivisione automatica di più fatture PDFs in ogni svizzero QR-fattura, ideale per scansionare lotti di fatture dei fornitori ed elaborarle singolarmente.
Crea fattura ZUGFeRD
Genera fatture elettroniche UE tedesche (PDF/A-3 con incorporato XML). Abbinare con svizzero QR-fattura per la fatturazione transfrontaliera DACH che copre Germania, Austria e Svizzera.
Stessa attività su altre piattaforme
Creare svizzero QR Fattura (Make)
Stessa Svizzera QR-operazione di fatturazione come Make modulo, con un generatore di scenari visivi e lo stesso SPS conformità, IBAN convalida e campi strutturati relativi a creditori/debitori.
Creare svizzero QR Conto (n8n)
Autogestito n8n flussi di lavoro con funzionalità intuitive per gli sviluppatori JSON supporto di espressione con lo stesso SPS Conformità per i sistemi di fatturazione svizzeri autogestiti.
Creare svizzero QR Bolletta (Power Automat)
Power Automate / Microsoft 365 flussi, ideali per SharePoint librerie di documenti, Outlook fatturazione e Dynamics Gestione finanziaria 365 giorni all'anno negli ambienti aziendali svizzeri.