Crea una fattura QR svizzera in n8n
Cosa fa questo nodo
PDF4me, Crea una fattura QR svizzera genera ricevute di pagamento QR svizzere pienamente conformi incorporate in PDF Documenti tramite il tuo n8n flusso di lavoro di automazione. Fornire un PDF fattura tramite dati binari, base64, URL, o nessun documento di sfondo, il nodo emette una fattura QR svizzera standardizzata con dettagli del creditore e del debitore, IBANnumeri di riferimento, etichette multilingue e formati di output configurabili in un unico passaggio automatizzato. Completamente compatibile con tutte le banche svizzere, PostFinancee gli standard di pagamento svizzeri (SPSspecifica.
Autenticazione del tuo API Richiesta
Ogni PDF4me nodo in n8n richiede un valido Credenziali per connettersi con. Crea o selezionane uno che contenga il tuo PDF4me API chiave affinché il flusso di lavoro possa autenticare in modo sicuro le richieste di generazione di fatture con codice QR svizzero.
Informazioni importanti da non perdere

Pannello superiore, connessione, tipo di input, dettagli di pagamento e campi relativi all'indirizzo del creditore

Pannello inferiore: indirizzo del debitore, tipo di riferimento, lingua, formato, impaginazione e configurazione dell'output.
Parametri
Richiesto nel n8n UI: Credenziali per la connessione, Tipo di dati di input, Importo, Valuta, IBAN, Nome del creditore, Tipo di indirizzo del creditore, Tipo di indirizzo del debitore finale, Tipo di riferimento, Tipo di lingua, Riga separatore, Tipo di formato e (quando il tipo di formato è PDF) Opzioni di impaginazione. Tutti i campi relativi alla riga dell'indirizzo, al codice postale e alla città sono contrassegnati come facoltativi nel UI ma sono fortemente consigliato per banconote QR svizzere valide, la specifica degli standard di pagamento svizzeri e il PDF4me API Trattali come effettivamente necessari per l'uso in produzione. Il payload di esecuzione li invia sempre (come stringhe vuote se vuoti).
| Parametro | Necessario | Cosa fa | Esempio |
|---|---|---|---|
| Input Data Type | Conditional | How the source PDF is supplied. None generates a standalone QR bill with no background document. Binary Data reads from a previous n8n node: the most common option. Base64 String accepts encoded file content. URL downloads from a public link. | Binary Data |
| Binary Property Name | Conditional | Name of the binary field from the previous node. Required when Input Data Type is Binary Data. Maps to the output binary field of a prior download or file node. | data |
| Base64 Content | Conditional | Base64-encoded PDF content. Required when Input Data Type is Base64 String. | JVBERi0xLjQK... |
| File URL | Conditional | Public URL to the source PDF file. Required when Input Data Type is URL. | https://example.com/invoice.pdf |
| File Name | Conditional | Filename of the source PDF input. Shown only when Input Data Type is Binary Data, Base64 String, or URL: hidden for None. Include the .pdf extension. | document.pdf |
| Amount | Yes | Payment amount for the Swiss QR bill. Enter without leading zeroes (per the node field description). Must be a positive number with up to two decimal places. | 1000 |
| Currency | Yes | Currency for the QR bill. Only two options accepted: CHF (Swiss Franc, standard for domestic Swiss payments) or EUR (cross-border transactions). | CHF |
| IBAN | Yes | Creditor's Swiss IBAN. Must start with CH followed by 19 digits and be linked to a valid PostFinance or Swiss bank account. An invalid IBAN halts the workflow. | CH0200700110003765824 |
| Creditor Name | Yes | Full name of the creditor company or individual as registered with the bank. Printed on the generated QR bill in the creditor section. | Test AG |
| Creditor Address Type | Yes | Address format for creditor information. Sent as code S (Structured: components stored separately for maximum SPS compliance) or K (Combined, two free-form lines). | Structured (S) |
| Creditor Address Line 1 | No | Street name for the creditor's address. Marked optional in the UI but required for valid Swiss QR bills: always provide it. When Address Type is Structured, enter the street name only. | Test Strasse |
| Creditor Address Line 2 | No | House number or secondary address detail. Used as the second address line when Creditor Address Type is Structured. | 1 |
| Creditor Postal Code | No | Swiss postal code for the creditor's address. Marked optional in the UI but required for valid Swiss QR bills. Must be a 4-digit Swiss postal code matching the creditor city. | 8000 |
| Creditor City | No | Swiss city name for the creditor's address. Marked optional in the UI but required for valid Swiss QR bills. Must correspond to the postal code entered above. | Zurich |
| Ultimate Debtor Name | No | Full name of the party who will pay the bill. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. Appears in the payment section of the printed QR bill. | Test Debt AG |
| Ultimate Debtor Address Type | Yes | Address format for the ultimate debtor. Sent as code S (Structured: recommended for automated Swiss banking) or K (Combined, two free-form lines). | Structured (S) |
| Ultimate Debtor Address Line 1 | No | Street name for the debtor's address. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. | Test Deb Strasse |
| Ultimate Debtor Address Line 2 | No | House number or secondary address line for the debtor. Used as the second line when Ultimate Debtor Address Type is Structured. | 2 |
| Ultimate Debtor Postal Code | No | Swiss postal code for the debtor's address. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. | 8000 |
| Ultimate Debtor City | No | Swiss city name for the debtor's address. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. | Zurich |
| Reference Type | Yes | Sent as code NON (No Reference: simple payments), QRR (QR Reference, 27-digit numeric for PostFinance/Swiss bank reconciliation), or SCOR (Creditor Reference, ISO 11649 for SEPA-compatible cross-border payments). | NON |
| Language Type | Yes | Display language for QR bill labels and printed text. Options: English, German, French, Italian. Choose the language matching the recipient's Swiss region. | English |
| Separator Line | Yes | Visual separator between the invoice body and the QR bill tear-off section. Note the node field name is spelled "seperatorLine". Options: Line With Scissor (Swiss standard), Simple Line, No Line. | Line With Scissor |
| Format Type | Yes | Output file format for the generated QR bill. PDF is recommended for print-ready documents. PNG and JPEG for digital delivery. TIFF for archival quality. Empty or null for raw data output. | PDF |
| Paging Options | Conditional | Controls where the QR bill slip is placed in the output document. Required when Format Type is PDF. Options: First, Last, Add Page At End, Custom. | First |
| Page Number | Conditional | Specific page index for placing the QR bill. Shown and required only when Format Type is PDF and Paging Options is Custom. | 3 |
| Output File Name | No | Filename for the generated Swiss QR bill document. Default value is provided by the node. Include the extension matching your chosen Format Type. | swissqr_bill.pdf |
| Output Binary Field Name | No | Name of the binary field in the n8n output that holds the generated QR bill file. Default is data. Used to reference the file in subsequent workflow nodes. | data |
Opzioni avanzate
Tutti i campi all'interno del Opzioni avanzate Le raccolte sono facoltative e forniscono un controllo aggiuntivo sul payload della fattura QR. Aggiungile tramite Aggiungi opzione nell'interfaccia utente del nodo.
riferimentomessaggio non strutturatoinformazioni di fatturazioneav1av2profiliOpzioni del tipo di dati di input
Scegli come la fonte PDF entra nel nodo. Ogni opzione si adatta a un diverso modello di flusso di lavoro.

Menu a tendina Tipo di dati di input, quattro opzioni controllano come la sorgente PDF viene fornito al nodo
NessunoNessun documento di baseDati binariFile dal nodo precedente, il più comunedati).Stringa Base64Contenuto del file codificato in Base64URLScarica da un link pubblicoOpzioni del tipo di indirizzo
Si applica a entrambi Tipo di indirizzo del creditore E Tipo di indirizzo del debitore finale. Scegli come vengono memorizzati i componenti dell'indirizzo nei dati del codice QR.
StrutturatoSi consiglia di utilizzare campi indirizzo separati.CombinatoDue righe di indirizzo a forma libera
Tipologia di indirizzo del creditore, strutturato o combinato

Tipo di indirizzo del debitore finale, stessa scelta del creditore
Opzioni del tipo di riferimento
Consente di controllare quale standard di riferimento di pagamento viene incorporato nel codice QR. Ciò influisce sul modo in cui il pagamento viene associato alla fattura nel sistema bancario.

Tipo di riferimento, Nessun riferimento, Riferimento QR o Riferimento del creditore
Nessun riferimentoPredefinito, nessun riferimento strutturatoRiferimento QRRiconciliazione bancaria svizzera a 27 cifre numericaRiferimento del creditoreISO 11649, transfrontaliero SEPA pagamentiOpzioni del tipo di formato
Controlla il formato del file del codice QR generato per la fattura.

Menu a tendina Tipo di formato, PDF, PNG, JPEG, TIFF, oppure vuoto (nullo)
PDFPredefinito, pronto per la stampaPNGDistribuzione via web e digitaleJPEGImmagine adatta all'invio tramite e-mailTIFFQualità da archivioVuoto (nullo)output dei dati grezziOpzioni di paginazione
Consente di controllare la posizione del codice QR della ricevuta di pagamento all'interno del documento di output, rispetto alle pagine della fattura esistente.

Opzioni di impaginazione: Prima, Ultima, Aggiungi pagina alla fine o Personalizzata
PrimoPredefinito, fattura QR a pagina 1ScorsoFattura tramite codice QR nell'ultima paginaAggiungi pagina alla fineLa pagina di fatturazione QR più comune e dedicataCostumePosizionamento specifico della paginaCampi di output
| Campo | Tipo | Cosa contiene |
|---|---|---|
fileName | String | Filename of the generated Swiss QR bill document, for example swissqr_bill.pdf. Map into an upload or email node as the destination filename. |
mimeType | String | MIME type of the output file, for example application/pdf. Useful for content type validation in downstream HTTP or storage nodes. |
fileSize | Number | Size of the generated QR bill file in bytes. Useful for storage planning, bandwidth monitoring, and conditional routing in the workflow. |
success | Boolean | True when the Swiss QR bill was created successfully. False if an error occurred during generation. Use this field to route error handling branches in your workflow. |
message | String | Human-readable status message confirming success or describing the error encountered. Useful for logging and error notification steps. |
Configurazione rapida
- Aggiungere PDF4me al tuo n8n flusso di lavoro. Imposta Risorsa A Fattura E Operazioni di fatturazione A Crea fattura SwissQR.
- In Credenziali per connettersi con, seleziona il tuo PDF4me credenziali o clicca Crea nuove credenziali e incolla il tuo API chiave.
- Impostato Tipo di dati di input: collega l'output binario di un nodo precedente (Dati binari), fornisci un Base64 stringa, fornire un pubblico URLoppure seleziona Nessuno per un codice QR autonomo.
- Inserisci il Quantità, Valuta (Franco svizzero per i pagamenti in CHF) e IBAN (valido CH svizzero) IBAN (che inizia con CH).
- Compilare tutto Creditore Campi: Nome, Tipo di indirizzo (si consiglia Strutturato), Indirizzo riga 1, Indirizzo riga 2, Codice postale e Città.
- Compilare tutto Debitore definitivo campi contenenti il nome completo e l'indirizzo del pagatore.
- Impostato Tipo di riferimento (Nessun riferimento è l'impostazione predefinita), Tipo di lingua (inglese, tedesco, francese o italiano) e Linea di separazione (La linea con le forbici è lo standard svizzero).
- Specificare Tipo di formato PDF consigliato) e Opzioni di paginazione (Aggiungi pagina alla fine per aggiungere una pagina di fattura con codice QR a una fattura esistente).
- Impostato Nome del file di output A
swissqr_bill.pdfE Nome del campo binario di output Adata. - Collega l'output al nodo successivo: invio email, caricamento su cloud storage, scrittura nel database ed esecuzione del flusso di lavoro.
Esempi di flusso di lavoro
Esempi di flusso di lavoroCommon n8n workflow patterns using Create Swiss QR Bill.
- Un trigger di pianificazione si attiva il primo giorno di ogni mese per avviare il ciclo di fatturazione.
- Un nodo di Google Drive elenca tutte le fatture PDFs nella cartella di fatturazione mensile, uno per cliente.
- Un nodo Loop Over Items scorre ogni file. Per ciascuno di essi, un nodo Google Drive Download recupera il contenuto binario.
- PDF4me Create Swiss QR Bill aggiunge una ricevuta di pagamento QR conforme a ogni fattura utilizzando l'importo del cliente, IBANe l'indirizzo è mappato da un record cliente di Google Sheets. Il tipo di lingua è impostato su tedesco. Le opzioni di impaginazione sono "Aggiungi pagina alla fine".
- Un nodo Gmail invia la fattura tramite codice QR PDF come allegato e-mail per ciascun cliente. Il nome del file utilizza l'ID del cliente per facilitarne l'identificazione.
- Un trigger Webhook si attiva quando un ordine viene confermato sulla piattaforma di e-commerce.
- UN HTTP Il nodo di richiesta genera una fattura PDF da un HTML modello utilizzando i dati dell'ordine.
- PDF4me Create Swiss QR Bill allega alla fattura un codice QR conforme alle normative. PDFL'importo e i dettagli del debitore vengono mappati dal payload del webhook. Il tipo di riferimento è impostato su Riferimento creditore per la riconciliazione. Il tipo di lingua è francese per la Svizzera francofona.
- Un Microsoft SharePoint il nodo carica la fattura QR completata PDF alla cartella Archivio ordini.
- UN HTTP Il nodo di richiesta aggiorna lo stato dell'ordine a Fattura inviata nel CRM sistema.
- Un trigger programmato si attiva ogni lunedì mattina per verificare la presenza di abbonamenti scaduti.
- Un nodo PostgreSQL interroga tutti i conti con saldi insoluti risalenti a più di 14 giorni.
- Un nodo Loop Over Items elabora ciascun abbonato. PDF4me La creazione della fattura QR svizzera viene chiamata con il tipo di dati di input impostato su Nessuno, senza sfondo PDFGenerazione di una fattura QR autonoma e pulita. Il nome e l'indirizzo del debitore vengono mappati dal record del database. Il tipo di riferimento è Nessun riferimento. Il tipo di lingua è Italiano per la Svizzera italofona.
- Un Microsoft Outlook Il nodo invia un'e-mail di promemoria di pagamento a ciascun abbonato con la fattura QR separata PDF allegato.
- Un nodo PostgreSQL registra il timestamp di invio del promemoria e incrementa il contatore dei promemoria per ciascun account.