Leggi il codice SwissQR in Zapier

Leggi il codice SwissQR è un Zapier azione da PDF4me che decodifica lo svizzero QR-fattura incorporata in un PDF e restituisce creditore, debitore, IBAN, importo e dati di riferimento come JSONUtilizzalo per rinominare automaticamente le fatture, associare i pagamenti alle registrazioni contabili o instradare i documenti per importo o riferimento senza inserimento manuale dei dati.

Articoli correlati del blog(1)

Si accumulano fatture con codice QR svizzero su Dropbox? Rinominatele automaticamente in Zapier con Code by Zapier.

Rinominare automaticamente i PDF delle fatture con codice QR svizzero in Zapier: Nuovo file nella cartella → PDF4me Leggi il codice SwissQR → Codice di Zapier (analizza JSON, estrai debitore/creditore) → Carica file. Nessun passaggio di ricerca file. Istruzioni dettagliate con screenshot di Dropbox. Compatibile con SharePoint e Google Drive.

Leggi il post →

Cosa fa questa azione

PDF4me Leggi il codice SwissQR ne prende uno PDF contenente un svizzero QR-conto (QR-Fattura) e restituisce i dati di pagamento strutturati, all'interno di uno Zap. Mappa il Filee l'azione restituisce Testo del documento, UN JSON corda con IBAN, creditore, creditore finale, debitore, importo, valuta e campi di riferimento. Analizzalo con un codice tramite Zapier Passaggio per guidare la ridenominazione delle fatture, l'abbinamento dei pagamenti o l'automazione contabile.

Autenticazione del tuo API Richiesta

Per accedere al PDF4me Web API Attraverso Zapier, ogni richiesta deve includere credenziali di autenticazione valide.

Get your API Key

Informazioni importanti da non perdere

Il testo del documento è un JSON stringa, non singoli campi

L'azione restituisce un campo, Testo del documento, mantenendo l'intero payload decodificato come un JSON stringa. Hai bisogno di un codice da Zapier (Esegui JavaScript) passaggio per Analisi JSON prima di mappare i valori individuali come IBAN O ud_Name.

I nomi dei campi utilizzano i prefissi cr_/ucr_/ud_

cr_ è il creditore, ucr_ è il creditore finale (spesso vuoto), e fuori_ è il debitore finale, in conformità con gli standard di pagamento svizzeri (SPCdenominazione dei campi. cr_Name E ud_Name sono i due campi più utilizzati nei flussi di lavoro.

Utilizzare il file originale per il PDF, non l'output di questa azione

Leggi il codice SwissQR che restituisce dati su PDFnon supera il test PDF se stesso in avanti. Continua a fare riferimento File dal tuo trigger per qualsiasi passaggio di caricamento file, e-mail o archiviazione.

Configurazione del pannello azioni: è richiesto solo il campo File, il nome del file è facoltativo.

Parametri

Richiesto nel Zapier UI: File. Il nome del file è facoltativo.

Parametro	Necessario	Cosa fa	Esempio
File	Required	The PDF containing the Swiss QR-bill to decode. Map from your trigger or a previous step.	1. File
File Name	Optional	Name for the response file. If left blank, the name is picked from the source URL.	invoice.pdf

Produzione

L'azione restituisce i metadati del file più un campo payload, Testo del documento, UN JSON stringa. Analizzala per raggiungere il singolo svizzero QR- campi della fattura elencati sotto la tabella.

Campo	Tipo	Cosa contiene
File Name	String	Name of the generated response file, from File Name or picked from the source URL.
File Extension	String	Extension of the response file, .json.
Full File Name	String	Complete filename including extension.
File Alternate Url	String	URL to the generated JSON response file.
Document Id	String	Unique identifier for this processing run.
File Size	Number	Size of the response file in bytes.
Doc Text	String (JSON)	The decoded Swiss QR-bill payload as a JSON string. Parse it to reach IBAN, creditor, debtor, amount, currency, and reference fields.

Campi di testo del documento (dopo JSON.parse)

Campo	Cosa contiene
QRType, Version, CodingType	Swiss Payment Standards header data identifying this as an SPC QR payload and its version.
IBAN	Creditor IBAN the payment settles to.
cr_Name, cr_StreetOrAddressLine1, cr_PostalCode, cr_City, cr_Country	Creditor (biller) name and address.
ucr_Name, ucr_StreetOrAddressLine1, ucr_PostalCode, ucr_City, ucr_Country	Ultimate creditor fields, populated only when the creditor differs from the ultimate payee.
Amount, Currency	Payment amount and currency (CHF or EUR).
ud_Name, ud_StreetOrAddressLine1, ud_PostalCode, ud_City, ud_Country	Ultimate debtor (payer) name and address.
ReferenceType, Reference	Reference type (QRR, SCOR, or NON) and the reference number itself.
UnstructuredMessage, BillingInfo	Free-text payment message and structured billing information, when present on the bill.

Come si imposta la lettura del codice SwissQR in Zapier?

1. Aggiungere PDF4me come app di azione nel tuo Zap e scegli Leggi il codice SwissQR.
2. Collega il tuo PDF4me crea un nuovo account o seleziona una connessione esistente.
3. Mappa File agli svizzeri QR-conto PDF dal tuo trigger o da un passaggio precedente. Facoltativamente mappa Nome del file.
4. Testare il passaggio e ispezionare Testo del documento nel pannello Dati in uscita, è un JSON corda.
5. Aggiungi un Codice di Zapier (Esegui JavaScript) passaggio che riceve il testo del documento, esegue Analisi JSONe restituisce il campo specifico di cui hai bisogno (ud_Name, cr_Name, IBAN, Riferimento, o altri).
6. Mappa che analizza il valore in Carica file (per rinominare), un Filtro O Percorsi passaggio (per l'instradamento) o un'azione su foglio di calcolo/contabilità.

Che cos'è lo svizzero? QR-Bill e perché ha bisogno di un lettore speciale?

Gli svizzeri QR-conto (QR-Rechnung) è il formato degli standard di pagamento svizzeri che è diventato l'unico bollettino di pagamento svizzero valido il 30 settembre 2022, sostituendo i vecchi bollettini di pagamento arancioni e rossi. Codifica creditore, debitore, IBAN, importo e dati di riferimento all'interno di un QR codice utilizzando il SPC (Codice di pagamento svizzero) struttura, un ordine di campo fisso che un codice a barre generico o QR Lo scanner legge come testo grezzo ma non può mappare a campi denominati. Leggi il codice SwissQR che decodifica questo SPC struttura e la restituisce come denominata JSON campi.

Configurazioni tipiche

Esempi di flusso di lavoroCommon Zapier patterns using Read SwissQR Code.

Rinominare automaticamente le fatture in base al nome del debitore

1. Un nuovo file nella cartella attiva (Dropbox, Google Drive, SharePoint) spara su un nuovo svizzero QR-conto PDF.
2. Il codice Read SwissQR viene eseguito con File e Nome file mappati dal trigger, restituendo il testo del documento.
3. Un codice di Zapier Il passaggio analizza il testo del documento e restituisce ud_Name (il debitore).
4. Carica file salva lo stesso PDF contenuto con il nome analizzato in modo che i file siano ricercabili dal pagatore.

Abbinare i pagamenti in entrata alle registrazioni contabili.

1. Un trigger di posta elettronica o cartella fornisce un messaggio svizzero QR-conto PDF.
2. Leggi gli estratti del codice SwissQR Doc Text, quindi un codice da Zapier analisi passo passo IBANImporto e riferimento.
3. In un sistema contabile (QuickBooks, Xero o un database personalizzato), una fase di ricerca associa il riferimento a una fattura aperta.
4. Una fase successiva contrassegna la fattura come pagata e registra la transazione.

Instradamento per importo o tipo di riferimento

1. Il codice SwissQR viene eseguito su una fattura in entrata e restituisce il testo del documento.
2. Un codice di Zapier Questo passaggio analizza l'importo e il tipo di riferimento.
3. Un passaggio di Paths dirama i pagamenti di valore elevato in una coda di approvazione manuale e QRR- Pagamenti di riferimento per la contabilizzazione automatizzata.

Consigli pratici

Doc Text always needs a parse step

There is no built-in field mapping for individual Swiss QR-bill values. Budget for a Code by Zapier step in every Zap that uses this action.

cr_ vs ud_ vs ucr_ is easy to mix up

cr_ is the creditor (who gets paid), ud_ is the ultimate debtor (who is paying), ucr_ is the ultimate creditor and is usually blank. Double-check which prefix your workflow actually needs.

ReferenceType tells you the reference format

QRR means a 27-digit QR reference, SCOR means a Creditor Reference (ISO 11649), NON means no structured reference, only UnstructuredMessage. Branch your parsing logic on ReferenceType if you support more than one format.

Amount can be null for open-amount bills

Some Swiss QR-bills are issued without a fixed Amount, letting the payer enter it. Handle a null or missing Amount in your Code by Zapier step rather than assuming it is always present.

The action reads, it does not validate compliance

This action decodes whatever SPC data is embedded in the QR code. It does not certify Swiss banking regulatory compliance, that responsibility stays with however the bill was originally issued.

Foglio riassuntivo

Campo	Valore
Action	Read SwissQR Code
File	Required, Swiss QR-bill PDF
File Name	Optional
Output payload	Doc Text (JSON string)
Common parsed fields	IBAN, cr_Name, ud_Name, Amount, Currency, Reference
Parse step needed	Code by Zapier, JSON.parse(Doc Text)
Counterpart action	Create SwissQR Bill (generates the QR-bill instead of reading it)

Domande frequenti

What does Read SwissQR Code actually return?+

The action returns Doc Text, a JSON string containing the decoded Swiss QR-bill fields: QRType, Version, CodingType, IBAN, creditor fields (cr_Name, cr_StreetOrAddressLine1, cr_PostalCode, cr_City, cr_Country), ultimate creditor fields (ucr_*), Amount, Currency, ultimate debtor fields (ud_Name, ud_StreetOrAddressLine1, ud_PostalCode, ud_City, ud_Country), ReferenceType, Reference, UnstructuredMessage, and BillingInfo. It also returns file metadata (File Name, File Extension, Full File Name, File Alternate Url, Document Id, File Size) for the generated JSON response file.

Do I need a separate step to parse the output?+

Yes. Doc Text is a single JSON string, not individually mapped fields. Add a Code by Zapier (Run JavaScript) step, run JSON.parse on the Doc Text value, and return the specific field you need such as data.ud_Name or data.IBAN so later steps in the Zap can map it directly.

What is the Swiss QR-bill and why does it need a special reader?+

The <a href="https://www.six-group.com/en/products-services/banking-services/payment-standardization/qr-bill.html" target="_blank" rel="noopener noreferrer">Swiss QR-bill (QR-Rechnung)</a> is the Swiss Payment Standards format that became the only valid Swiss payment slip on 30 September 2022. It encodes structured payment data (IBAN, creditor, debtor, amount, reference) inside a QR code using the SPC data format, a fixed field order that a generic barcode or QR scanner cannot parse into named fields without knowing that structure.

Can I use the extracted data to rename or route the PDF?+

Yes. A common pattern parses Doc Text for ud_Name (debtor) or cr_Name (creditor) and uses that value as the filename in an Upload File step, or checks Reference or Amount in a Filter or Paths step to route the invoice. Use the original File field from your trigger for the file content, this action's output only carries data, not the PDF. See <a href="https://www.iso20022.org/" target="_blank" rel="noopener noreferrer">ISO 20022</a> for background on the structured payment messaging standard the Swiss QR-bill builds on.

Azioni correlate

Crea fattura SwissQR

L'azione corrispondente genera un'azione svizzera QR-conto PDF da IBAN, creditore e dati sull'importo invece di leggerne uno.

Classifica il documento

Ordina in entrata PDFs prima per tipo, poi esegui Leggi codice SwissQR solo su quelli classificati come svizzeri QR-fatture.

Analizza il documento

Per fatture senza codice postale svizzero QR-fattura, estrarre i dati delle voci e dell'intestazione utilizzando invece un modello di analisi mappato.

Casi d'uso e applicazioni industriali

Swiss Banking & Financial Services

• Elaborazione dei pagamenti: Leggi i codici SwissQR per l'elaborazione automatizzata dei pagamenti e la gestione delle transazioni
• Gestione delle transazioniEstrazione dei dati di pagamento per un'elaborazione e una riconciliazione complete delle transazioni.
• Segnalazione di conformità: Inserire i dati di riferimento e di importo decodificati nei registri di controllo interni
• Assistenza clienti: Elabora pagamenti e richieste dei clienti con riconoscimento automatico del codice SwissQR

Swiss Business & Professional Services

• Elaborazione delle fatture: Leggi i codici SwissQR dalle fatture per l'elaborazione automatizzata dei pagamenti e la contabilità
• Gestione clientiEstrazione delle informazioni di pagamento per la fatturazione e il monitoraggio dei pagamenti dei clienti.
• Gestione finanziaria: Automatizza la lettura dei codici SwissQR per una gestione finanziaria completa
• Automazione dei datiSemplifica l'elaborazione dei documenti aziendali grazie alla lettura integrata del codice SwissQR.

Swiss E-commerce & Retail

• Elaborazione degli ordiniLeggi i codici SwissQR per l'elaborazione automatizzata degli ordini e la riscossione dei pagamenti.
• Tracciamento dei pagamentiEstrarre i dati di pagamento per un monitoraggio completo degli ordini e dei pagamenti.
• Esperienza del clienteMigliora l'esperienza di pagamento dei clienti con l'elaborazione automatizzata dei codici SwissQR.
• Gestione dell'inventario: Collegare i dati di pagamento alla gestione dell'inventario e all'evasione degli ordini

Swiss Government & Public Sector

• Servizi pubbliciLeggi i codici SwissQR per i servizi governativi e l'elaborazione dei pagamenti nel settore pubblico.
• Amministrazione fiscaleEstrazione dei dati di pagamento per il versamento delle imposte e l'elaborazione delle tasse governative.
• Gestione dei documenti: Inserire i dati di pagamento decodificati nei sistemi di contabilità interni del settore pubblico.
• Servizi digitaliModernizzare l'elaborazione dei pagamenti nel settore pubblico con l'automazione tramite codice SwissQR.

Richiedi assistenza

Zapier IntegrationGet your API KeyZapier Documentation