Passa al contenuto principale

Leggi il codice SwissQR in Make

Leggi il codice SwissQR è un Make modulo che legge Swiss QR codici da PDF fatture automaticamente, estraendo il completo QR-conto (QR(Fattura) payload: IBAN, importo, valuta (CHF/EUR), creditore, debitore e numero di riferimento. Usalo per automatizzare i conti fornitori e la riconciliazione dei pagamenti per le fatture svizzere in Make senza inserimento manuale dei dati.

Cosa fa questo modulo

PDF4meLeggi il codice SwissQR rileva e decodifica automaticamente lo svizzero QR-conto (QR-Rechnung) payload da qualsiasi PDF fattura nel tuo Make scenario. Restituisce ogni campo di pagamento strutturato e pronto all'uso, IBANImporto, valuta, nome e indirizzo del creditore, dettagli del debitore, numero di riferimento e informazioni di fatturazione aggiuntive, in modo che il flusso di lavoro di contabilità fornitori, riconciliazione o avvio dei pagamenti possa essere eseguito senza che nessuno legga o digiti manualmente i dati della fattura.

Articoli correlati del blog(1)

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 decodifica delle richieste in modo sicuro.

Informazioni importanti da non perdere

Sono supportati tutti e tre i tipi di riferimento svizzeri.
Il modulo gestisce QRR (27 cifre QR riferimento utilizzato per la corrispondenza bancaria automatica), SCOR ISO 11649 riferimento del creditore), e NON (nessun riferimento). Il campo Tipo di riferimento nell'output indica esattamente quale formato è stato trovato nella fattura, in modo che la logica successiva possa gestire correttamente ogni caso.
QR il codice viene trovato automaticamente su qualsiasi pagina
Non è necessario dire al modulo quale pagina è quella svizzera QR il codice appare su. Scansiona ogni pagina del PDF e individua il QR-fattura automatica, indipendentemente dal fatto che la fattura sia di una o più pagine. Ciò significa che è possibile elaborare fatture multipagina PDFsenza alcuna pre-divisione o configurazione del numero di pagina.
Le informazioni aggiuntive possono contenere dati contabili Swico S1
Quando l'emittente della fattura ha incluso le informazioni di fatturazione strutturata Swico S1 nella QR payload, il campo Informazioni aggiuntive lo restituisce insieme al testo del messaggio non strutturato. Swico S1 può includere VAT tariffe, condizioni di pagamento e riferimenti contabili, dati aggiuntivi che vanno oltre i campi di pagamento principali e sono utili per l'automazione AP prenotazione.
Crea il modulo PDF4me Read SwissQR Code che mostra la connessione impostata su TestUser01, il file impostato su Map con i campi Nome file e Documento mappati dal passaggio 1

File impostato su Map passa il nome del file e PDF buffer da qualsiasi modulo precedente. Il modulo scansiona ogni pagina e restituisce l'intero Swiss QR-Caricamento utile per il pagamento delle bollette.

Parametri

Necessario: Connessione, nome file e documento devono essere tutti forniti. PDF deve contenere un valido documento svizzero QR-fattura per il modulo per restituire i dati di pagamento.

ParametroNecessarioCosa faEsempio
ConnectionRequiredPDF4me API connection. Click Add and paste your API key if connecting for the first time.Your PDF4me connection
File NameRequiredSource PDF filename including the .pdf extension. Map from the prior module's file name output.swiss_invoice_2024.pdf
DocumentRequiredBinary PDF buffer from a prior module: cloud storage download (Dropbox, Google Drive, SharePoint), email attachment, or HTTP response. The PDF must contain a Swiss QR-bill on any page.1. Data
IsAsyncConditionalSet to true for async processing. Returns a polling URL instead of waiting inline. Use for large PDFs or high-volume batch runs where Make timeout limits apply.false

Produzione

Il modulo restituisce l'intero Swiss QR-payload della fattura come singoli campi mappati nel Make fascio.

CampoTipoCosa contiene
IBANStringInternational Bank Account Number of the payee. 21-character Swiss IBAN starting with CH or LI.
AmountStringPayment amount as a string (e.g. "1250.00"). Convert to Number in Make if arithmetic is needed downstream.
CurrencyStringCHF or EUR. The Swiss Payment Standard allows only these two values.
CreditorObjectCreditor name, address type (K or S), street/PO box, building number, postcode, town, and country.
DebtorObjectDebtor (payer) name and address fields, same structure as Creditor. May be empty if the invoice omits debtor data.
ReferenceStringThe reference number: 27-digit QRR, ISO 11649 SCOR, or empty string for NON reference type.
Reference TypeStringQRR, SCOR, or NON. Identifies the reference format so your downstream logic can branch accordingly.
Additional InfoStringUnstructured message text and Swico S1 structured billing data (VAT rates, payment conditions, accounting codes) when included by the invoice issuer.

Come si imposta la lettura del codice SwissQR in Make?

  1. Aggiungere PDF4meLeggi il codice SwissQR al tuo Make scenario.
  2. Seleziona Connessione (oppure fai clic) Aggiungere per crearne uno con il tuo API chiave).
  3. Mappa Nome del file E Documento dal modulo precedente: un monitoraggio degli allegati e-mail, un recupero del file dall'archivio cloud o HTTP scaricamento.
  4. Fare clic Salva e avviare lo scenario. I campi di output: IBAN, Quantità, Valuta, Creditore, Debitore, Riferimento, Tipo di riferimento, E Informazioni aggiuntive: sono tutti disponibili per essere mappati nei moduli a valle.

Quando dovrei usare Read SwissQR Code in Make?

Esempi di flusso di lavoroCommon Make scenario patterns using Read SwissQR Code.
Automatizza la gestione dei pagamenti dai fornitori a partire dalle fatture svizzere in entrata.
  1. Email Watch si attiva quando una fattura del fornitore con un indirizzo svizzero QR-Arriva la fattura.
  2. Leggi gli estratti del codice SwissQR IBANImporto, riferimento e dettagli del creditore.
  3. UN HTTP il modulo invia i dati di pagamento al sistema bancario aziendale o ERP API.
  4. Viene creata una riga in Fogli Google che registra il riferimento della fattura, l'importo e il creditore per la AP registrare.
Abbinare i pagamenti bancari in entrata alle fatture aperte
  1. Un processo programmato si attiva quotidianamente per elaborare il download dell'estratto conto bancario.
  2. Per ogni pagamento non abbinato, Read SwissQR Code estrae il riferimento dalla fattura inviata corrispondente. PDF.
  3. Il riferimento viene confrontato con i record delle fatture aperte nel database e le fatture corrispondenti vengono contrassegnate automaticamente come pagate.
  4. Viene inviata un'e-mail di riepilogo al AR Elenco delle squadre con i pagamenti abbinati e non abbinati per la giornata.
Archivia le fatture per nome del creditore utilizzando QR dati
  1. La cartella di monitoraggio di Dropbox si attiva quando viene ricevuta una nuova fattura svizzera. PDF viene spostato nella cartella Posta in arrivo.
  2. Leggi il codice SwissQR che estrae il nome del creditore e il riferimento dal QR carico utile.
  3. Google Drive crea una cartella per il creditore (se non esiste) e carica la fattura con il riferimento come nome del file.
  4. Una notifica Slack avvisa il AP Il team è stato informato che è stata emessa una nuova fattura ed è pronta per l'approvazione.

Domande frequenti

What is a Swiss QR-bill and which reference types does this module support?+
A Swiss QR-bill (QR-Rechnung) is the standardised Swiss invoice format defined by the <a href="https://www.six-group.com/en/products-services/banking-services/payment-standardization/standards/qr-bill.html" target="_blank" rel="noopener noreferrer">SIX Group Swiss Payment Standard</a> that replaced payment slips in 2020. It carries a machine-readable QR code encoding all payment fields. This module supports all three reference types defined in the Swiss Payment Standard: QRR (27-digit numeric QR reference for automatic bank matching), SCOR (ISO 11649 creditor reference), and NON (no reference number). The Reference Type output field identifies which was detected. For more on Make scenario setup, see the <a href="https://www.make.com/en/help/apps/pdf4me" target="_blank" rel="noopener noreferrer">Make PDF4me integration docs</a>.
Does it work on scanned Swiss invoices?+
Yes. The module processes both digitally generated PDFs and scanned paper invoices. For reliable QR extraction from scanned documents, a minimum resolution of 200 DPI is recommended. The module scans every page of the PDF automatically: you do not need to specify the page number where the QR-bill appears.
What currencies are supported?+
The Swiss Payment Standard defines exactly two valid currencies: CHF (Swiss Franc) and EUR (Euro). The Currency output field will always contain one of these two values as encoded in the QR payload.
What does the Additional Info field contain and is it useful for accounting?+
The Additional Info field returns two types of data: unstructured payment message text (a free-text note the invoice issuer has added) and Swico S1 structured billing information when present. Swico S1 can include VAT rates, payment conditions, and accounting reference codes: AP-relevant data that goes well beyond the core payment fields and is useful for automated invoice booking.
How do I use the extracted IBAN and amount to initiate a payment?+
Map the IBAN and Amount output fields into a banking integration module or HTTP request that connects to your payment gateway or ERP. You can also write them to a Google Sheet or database row as a pending payment record and route it through a manager approval workflow before the actual payment is triggered.

Moduli correlati

Richiedi assistenza