Passa al contenuto principale
PDF4me APIIntegrazioniBase di conoscenzaEstensioniTester APIBlog

Leggi il codice QR svizzero utilizzando n8n azione

PDF4me Leggi il codice QR svizzero estrae e analizza i dati di pagamento dai codici QR svizzeri incorporati in PDF Documenti tramite n8n Flussi di lavoro automatizzati. Processo PDFs via n8n trigger, dati binari, stringhe base64 o pubblico URLper decodificare automaticamente le fatture QR svizzere e recuperare le informazioni di pagamento strutturate, inclusi i dettagli del creditore/debitore, IBANImporti dei pagamenti, valuta, numeri di riferimento e informazioni di fatturazione, nel pieno rispetto degli standard di pagamento svizzeri. Questa soluzione è ideale per l'elaborazione automatizzata dei pagamenti, la riconciliazione delle fatture, l'integrazione con i sistemi contabili, i flussi di lavoro finanziari e la conformità normativa che richiedono un'estrazione accurata dei dati dai codici QR svizzeri.

Articoli correlati del blog(1)

Impostare​

Aggiungi il PDF4me nodo "Leggi il codice QR svizzero" al tuo n8n flusso di lavoro e configurare i parametri richiesti. Per le istruzioni di configurazione iniziale, consultare il nostro n8n Guida all'integrazione.

Prerequisiti:

  • PDF4me API credenziali
  • n8n accesso al flusso di lavoro
Get Your API Key

Configurazione:

  1. Aggiungere PDF4me nodo al flusso di lavoro
  2. Seleziona l'azione "Leggi il codice QR svizzero"
  3. Configura i parametri di input (vedi sotto)
Leggi il codice QR svizzero

Parametri​

Elenco completo dei parametri per l'azione "Leggi codice QR svizzero". Configura questi parametri per estrarre i dati dai codici QR svizzeri.

Importante: I parametri contrassegnati da un asterisco (***) sono obbligatori e devono essere forniti affinché l'azione funzioni correttamente.

ParametroTipoDescrizioneEsempio
Tipo di dati di input***StringSelezione del formato di inserimento del codice QR
• Scegli il formato di inserimento dei dati del tuo codice QR
• PDF4me supporta diversi tipi di input per l'elaborazione dei codici QR svizzeri
• Opzioni: Dati binari, Base64 Corda o URL		Binary Data
Campo binario di inputBinarioInserimento di un'immagine di codice QR binario (Obbligatorio se si tratta di dati binari)
• Fare riferimento al file immagine del codice QR precedente n8n nodo o caricamento
• PDF4me elabora immagini binarie con riconoscimento automatico del codice QR
• Obbligatorio quando il tipo di dati di input è "Dati binari"		{{ $binary.data }}
Contenuto del documento in Base64StringBase64 Inserimento del codice QR codificato (Obbligatorio se Base64 Corda)
• Fornire i dati dell'immagine del codice QR come stringa codificata in base64
• PDF4me decodifica ed elabora automaticamente il contenuto del codice QR
• Obbligatorio quando il tipo di dati di input è "Base64 Corda"		UEsDBBQABgAI...
Server di fileStringCodice QR pubblico URL Input (Obbligatorio se URL)
• Fornire un'autorizzazione pubblica/aperta URL al file immagine del codice QR
• PDF4me scarica ed elabora il file da URL
• Obbligatorio quando il tipo di dati di input è "URL"		https://abc.com/qr.png
Nome del file di output***StringNome file di output dei dati QR svizzeri
• Specificare il nome per il file generato JSON file con i dati estratti
• Deve includere l'estensione .json
• PDF4me garantisce la convalida univoca della denominazione e del formato		swissqr_code_data.json
Asincrono***BooleanElaborazione asincrona
• Abilitare l'elaborazione asincrona per la lettura dei codici QR svizzeri
• true = elaborazione in background per prestazioni migliori
• false = elaborazione sincrona per risultati immediati
• Ideale per operazioni ad alto volume		true

Opzioni avanzate​

Nella sezione Opzioni avanzate sono disponibili i seguenti parametri, che sono facoltativi:

ParametroTipoDescrizioneEsempio
Profili personalizzatiStringProfili di configurazione personalizzati
• Imposta opzioni aggiuntive utilizzando profili personalizzati
• JSON-formato simile contenente parametri predefiniti
• Consente impostazioni avanzate per la lettura dei codici QR svizzeri
• Opzionale per esigenze specifiche		{ "outputDataFormat": "json", "validateSwissStandards": true }

Produzione​

Parametri di output​

ParametroTipoDescrizioneEsempio
Nome fileStringPDF4me Nome del file dei dati QR svizzeri - Il nome completo del file generato con successo JSON file contenente i dati estratti del codice QR svizzero con la corretta estensione .json. PDF4me Garantisce una denominazione univoca e convalida la conformità del formato dei file per una perfetta integrazione con i processi a valle.swissqr_code_data.json
tipo mimeStringPDF4me JSON dati MIME tipo - IL MIME tipo del generato JSON file contenente i dati del codice QR svizzero, che indicano il formato del file per una corretta gestione nelle applicazioni web e nei file systemapplication/json
Dimensione fileNumeroPDF4me JSON dimensione del file in byte - La dimensione esatta del generato JSON file in byte, fornito da PDF4me Per la pianificazione dello storage, l'ottimizzazione della larghezza di banda e il monitoraggio del trasferimento dei file. Essenziale per la gestione documentale aziendale e l'automazione dei flussi di lavoro.1024
successoBooleanPDF4me Indicatore di stato di lettura QR svizzero - Indicatore booleano che segnala il successo o il fallimento del processo di lettura del codice QR svizzero. PDF4me resi true per una lettura di successo e false per eventuali errori, consentendo una gestione degli errori efficace nei flussi di lavoro automatizzatitrue
swissQrDataObjectPDF4me dati QR svizzeri estratti - Dati strutturati completi estratti dal codice QR svizzero, incluse informazioni di pagamento, dettagli del creditore e dati della transazione. Contiene tutte le informazioni rilevanti secondo gli standard svizzeri dei codici QR.{"ucr_PostalCode": "", "ucr_City": "", "ucr_Country": null, "Amount": 30, "Currency": "CHF", "ud_AddressType": "S", "ud_Name": "Heinz Muster", "ud_StreetOrAddressLine1": "Tödistrasse", "ud_BuildNoOrAddressLine2": "1", "ud_PostalCode": "8000", "ud_City": "Zürich", "ud_Country": "Switzerland", "ReferenceType": "QRR", "Reference": "210000000003139471430009017", "UnstructuredMessage": "for individuals", "BillingInfo": "S1/01/20200109/33/123455/99/0/123258/30/CH2345677/40/1020/41/300", "av1_Parameters": "", "av2_Parameters": ""}

N8N Risposta all'azione​

IL PDF4me Leggi il codice QR svizzero API Restituisce una risposta che può essere visualizzata in diversi formati. Scegli la visualizzazione più adatta alle tue esigenze:

JSON Formato di risposta

Il grezzo JSON risposta da API:

{
  "fileName": "swissqr_code_data.json",
  "mimeType": "application/json",
  "fileSize": 1024,
  "success": true,
  "swissQrData": {
    "ucr_PostalCode": "",
    "ucr_City": "",
    "ucr_Country": null,
    "Amount": 30,
    "Currency": "CHF",
    "ud_AddressType": "S",
    "ud_Name": "Heinz Muster",
    "ud_StreetOrAddressLine1": "Tödistrasse",
    "ud_BuildNoOrAddressLine2": "1",
    "ud_PostalCode": "8000",
    "ud_City": "Zürich",
    "ud_Country": "Switzerland",
    "ReferenceType": "QRR",
    "Reference": "210000000003139471430009017",
    "UnstructuredMessage": "for individuals",
    "BillingInfo": "S1/01/20200109/33/123455/99/0/123258/30/CH2345677/40/1020/41/300",
    "av1_Parameters": "",
    "av2_Parameters": ""
  }
}

Casi d'uso​

Elaborazione dei pagamenti e servizi bancari svizzeri​

  • Elabora automaticamente i pagamenti delle bollette tramite QR code svizzero leggendo le informazioni di pagamento da fatture, ricevute e documenti di pagamento per consentire la riconciliazione automatica dei pagamenti e l'integrazione contabile.
  • Estrarre i dettagli di pagamento dai codici QR svizzeri incorporati nelle fatture e nelle bollette per facilitare l'elaborazione automatizzata dei pagamenti e ridurre l'inserimento manuale dei dati nei sistemi bancari e finanziari svizzeri.
  • Elabora le conferme di pagamento e le registrazioni delle transazioni leggendo i codici QR svizzeri per verificare gli importi dei pagamenti, le informazioni sul destinatario e i riferimenti delle transazioni, ai fini della conformità finanziaria svizzera.

Gestione aziendale e della fatturazione in Svizzera​

  • Leggere i codici QR svizzeri presenti su fatture e documenti di pagamento consente di estrarre informazioni sui clienti, importi dei pagamenti e dettagli delle transazioni, automatizzando così i processi contabili e di tenuta della contabilità.
  • Elabora i pagamenti e i documenti ufficiali del governo svizzero leggendo i codici QR svizzeri per estrarre le informazioni di pagamento e garantire la conformità con le normative finanziarie e gli obblighi di rendicontazione fiscale svizzeri.
  • Estrarre i dati di pagamento dai codici QR svizzeri presenti nelle bollette delle utenze, nelle fatture dei servizi e nei pagamenti degli abbonamenti per consentire l'elaborazione automatizzata dei pagamenti e la gestione degli account dei clienti.

Commercio elettronico e transazioni digitali in Svizzera​

  • Elabora pagamenti online e transazioni di e-commerce leggendo i codici QR svizzeri presenti sulle ricevute digitali e sulle conferme di pagamento, per consentire l'elaborazione automatizzata degli ordini e i flussi di lavoro del servizio clienti.
  • Estrarre le informazioni di pagamento dai codici QR svizzeri presenti nelle app di pagamento mobile e nei portafogli digitali per facilitare la verifica delle transazioni e la tenuta automatizzata dei registri finanziari.
  • Elabora i pagamenti degli abbonamenti e la fatturazione ricorrente leggendo i codici QR svizzeri per estrarre i dettagli di pagamento e abilitare la gestione automatizzata della fatturazione per clienti e aziende svizzere.

Richiedi assistenza​

n8n Integration GuideGet your API Keyn8n SampleGetting Started