Fattura con codice QR svizzero da Airtable in Zapier: filtra le righe, genera la ricevuta, invia un'email al debitore
Filter by Zapier è il passaggio che decide quali righe Airtable diventano bollettini di pagamento. Inserendolo tra un trigger New Record e PDF4me, solo le righe contrassegnate come pronte riceveranno una fattura con codice QR svizzero, che verrà poi riscritta nel record e inviata via email al debitore.
Uno Zap che monitora una tabella si attiva a ogni riga aggiunta. Per la maggior parte delle automazioni, questo è semplicemente uno spreco. Per un'automazione che invia via email a un cliente una ricevuta di pagamento, fa la differenza tra un processo funzionante e l'invio della stessa fattura tre volte perché qualcuno stava ancora digitando quando il trigger ha effettuato il polling. La fase di filtro è la soluzione completa, ed è importante comprenderla a fondo piuttosto che copiarla.
Qualcuno compila una riga Airtable e imposta Status su New. Zap lo rileva, il filtro controlla quel campo, PDF4me genera una fattura con codice QR svizzero e l'immagine viene reinserita nel record mentre una copia viene inviata al debitore via e-mail. Impostare lo stato su Generated nella stessa esecuzione è ciò che impedisce a Zap di rilevarlo nuovamente. Cinque passaggi, e quello interessante è il filtro.
Domande e risposte basate sul "perché"
Why does this need a Filter step at all?Poiché il trigger Airtable di Zapier non ha una condizione propria, ti invia ogni nuovo record e lascia a te la decisione. Una riga digitata solo a metà, un duplicato, un record creato da qualcuno per fare una prova: tutti questi elementi raggiungono il passaggio 3 a meno che qualcosa non lo impedisca, e il passaggio 5 invia un'email al cliente.
Why filter on Status rather than checking the fields are filled in?Poiché Status è una decisione presa da una persona, mentre le altre colonne contengono solo dati, si potrebbe verificare che il QR-IBAN non sia vuoto e che l'importo sia superiore a zero, ma si continuerebbe a ipotizzare se la riga sia stata completata. Un campo che indica "Ho finito" è più semplice e trasparente riguardo a chi è responsabile.
Why clean the IBAN in Airtable instead of in the Zap?Poiché Zapier non ha un linguaggio di espressione in un campo. Make ti consente di racchiudere un valore inreplace() dove lo usi; Zapier no. Quindi la pulizia avviene un passo prima, nei campi formula di Airtable, e lo Zap li mappa. L'effetto collaterale è piacevole: i valori puliti sono visibili nella griglia, quindi puoi vedere cosa invierà lo Zap prima che lo invii.
Why does step 4 warn about a loop?Poiché scrive nella tabella che attiva lo Zap, in linea di principio il suo stesso aggiornamento potrebbe riattivare lo Zap. In questa build ciò non è possibile, perché l'aggiornamento imposta Status su Generated e il filtro passa solo New. Vale la pena comprenderlo piuttosto che ignorarlo: il filtro non è solo una misura di ordine, è ciò che interrompe il ciclo.
Cosa riceverai
Input: una riga Airtable con un creditore, un debitore, un importo, un QR-IBAN e un riferimento, con Status impostato su New. Output: una fattura QR svizzera relativa a tale record, la riga contrassegnata come Generated con un link e un'e-mail al debitore.
Osservate le due colonne a destra. QRIBANClean e AmountText sono campi formula e sono ciò che Zap effettivamente mappa.
Scontrino, linea di taglio, sezione pagamento. Il layout è predefinito.
L'importo visualizzato è 100,50, non 100,5, perché il corpo del documento mappa anche il campo della formula.
Di cosa hai bisogno
- A Zapier accountsu un piano che consente Zap a più fasi.Filter by Zapier è integrato, ma conta come un passaggio.
- Chiave API PDF4me. Ottieni la tua chiave API.
- An Airtable baseLa base dati acquisita è
PDF4me Live Automationscon una tabella denominataSwiss QR Requests: il blocco creditore, il blocco debitore, QRIBAN, Riferimento, Importo, Valuta, Messaggio, Email, un campo Status, un campo OutputLink e un campo allegato chiamatoDocument. - Two Airtable formula fields.
QRIBANCleanrimuove gli spazi dal QR-IBAN,AmountTextformatta l'importo con due cifre decimali. Vedi ilAirtable formula reference se non ne hai mai scritto uno prima. - A Gmail accountcollegato a Zapier ea QR-IBAN dalla tua banca. Un riferimento QR richiede un QR-IBAN, non un IBAN ordinario.
Zap in sintesi
- New Record (Airtable) viene attivato ad ogni nuova riga nelle
Swiss QR Requests. - Filter conditions (Filter by Zapier) continuano solo quando Status è esattamente
New. - Create SwissQR Bill (PDF4me) che converte la ricevuta in un PNG.
- Update Record (Airtable) scrive il file, lo stato e un collegamento alla riga.
- Send Email (Gmail) per recapitare la ricevuta al debitore.
Panoramica completa di Zap
Un'esecuzione riuscita. Il filtro in posizione 2 è ciò che rende sicuri i tre passaggi successivi.
Passaggio 1: Come si attiva uno Zap da una nuova riga Airtable?
Flusso finora: ancora niente, questo è il trigger.
- Crea uno Zap e seleziona Airtable > New Record.
- Collega il tuo account, quindi scegli Automazioni Live Base
PDF4me Live Automationse la TableSwiss QR Requests. - Test. Zapier segnala di aver trovato 1 nuovo record in Airtable e che tutte le colonne diventano disponibili per le fasi successive.
Il badge di sondaggio sullo Zap catturato indica 2 minuti, un valore predefinito dal piano e non configurabile qui.
Tip.New Record significa nuovo, non modificato. Se qualcuno crea una riga e la compila dieci minuti dopo, Zap l'avrà già vista come vuota e il filtro l'avrà già rifiutata, quindi non verrà eseguito nulla al termine dell'operazione. Se il tuo team lavora in questo modo, attiva l'azione in caso di evento di aggiornamento del record e mantieni lo stesso filtro.
Passaggio 2: Come si interrompe l'esecuzione di uno Zap su righe non pronte?
Flusso finora: il trigger Airtable.
Questo è il passaggio da cui dipende il resto dello Zap.
- Aggiungi Filter by Zapier > Only continue if...
- Crea una regola:
- Campo: 1. Status
- Condizione: (Testo) Exactly matches
- Valore:
New
- Mettilo alla prova. Zapier ti dice se il record registrato sarebbe continuato e indica il campo che ha preso la decisione.
Configurazione Filter conditions
Questo filtro funziona correttamente, non sta fallendo. Il record di prova è già stato Generated, quindi Zap rifiuta correttamente di emettere una seconda ricevuta.
Quel riquadro giallo merita di essere letto attentamente, perché è l'informazione più utile sullo schermo. Il messaggio "Il tuo zap non sarebbe continuato" non è un errore. Zapier ha testato la regola sul record più recente, che aveva Status Generated " da un'esecuzione precedente, e il filtro ha svolto correttamente il suo compito. Gli elementi che non corrispondevano indicavano il campo e il valore esatti che ne avevano causato l'interruzione.
Tip.Exactly matches Distingue tra maiuscole e minuscole e tra spazi bianchi.new ENew con uno spazio finale entrambi falliscono, silenziosamente, su ogni riga. Se un filtro non viene mai superato, confronta il valore nel riquadro giallo con la tua regola carattere per carattere prima di modificare qualsiasi altra cosa. Un singolo campo di selezione è più sicuro del testo libero in questo caso proprio perché nessuno può digitare male.
Passaggio 3: Come si trasforma la riga in una banconota con codice QR svizzero?
Flusso finora: il trigger e il filtro.
Da qui in poi, tutto viene eseguito solo per le righe che sono passate.
- Aggiungi PDF4me > Create SwissQR Bill.
- Imposta i campi che definiscono l'output:
- Format Type:
PNG - Valuta:
CHF - Reference Type:
QRR - Language Type:
English - Separator Line:
Line with Scissor - Creditor Address Type e Ultimate Debtor Address Type:
S
- Format Type:
- Mappa i dati di pagamento dal trigger:
- Amount: il campo formula Amount Text, non l'importo grezzo
- IBAN: il campo formula QRIBAN Clean
- Creditor Name, Creditor Street, Creditor City, Creditor Postal Code dalle colonne del creditore, con Creditor Country impostato su
CH-Switzerland - I campi relativi al debitore finale provengono dalle colonne del debitore, stesso schema
- Reference e Unstructured Message dalla riga
Create SwissQR Bill
L'importo e l'IBAN provengono entrambi da campi formula. Tutto il resto viene mappato direttamente dalla colonna corrispondente.
Ciò che decide ogni impostazione
| Campo | Valore qui | Ciò che controlla |
|---|---|---|
| Format Type | PNG | Un'immagine anziché un PDF, la cui anteprima viene visualizzata direttamente nella cella di allegato Airtable |
| Reference Type | QRR | Un riferimento QR strutturato, che richiede un QR-IBAN. Le alternative sono SCOR e NON |
| Separator Line | Line with Scissor | Traccia la linea di taglio tra la parte della ricevuta e quella del pagamento. |
| Creditor Address Type | S | Indirizzo strutturato: via, codice postale e città in campi separati |
| Quantità | AmountText | Il campo formula, già a due cifre decimali |
| IBAN | QRIBANClean | Il campo della formula, già privo di spazi |
Tip.Reference Type e il conto devono corrispondere. QRR richiede un QR-IBAN e un riferimento di 27 cifre. Se si utilizza un IBAN ordinario, si ottiene una ricevuta apparentemente corretta ma non scansionabile, il che rappresenta il peggior tipo di errore perché Zap non segnala alcun problema.
Passaggio 4: Come si riscrive la ricevuta sul registro?
Flusso finora: tutto attraverso il passaggio PDF4me.
- Aggiungi Airtable > Update Record.
- Specificare:
- Base e Table: come nel passaggio 1
- Record: l' ID del trigger
- Append attachments:
False - Document: l' File Url dal passaggio 3
- Status:
Generated - OutputLink: l'URL del record, se ne conservi uno
- Lascia vuoto un campo sì e uno no.
Update Record
Tre campi compilati, tutto il resto lasciato vuoto. Questo elenco rappresenta il controllo di sicurezza prima di accendere lo Zap.
Qui ci sono due differenze rispetto a come si procederebbe altrove. L'allegato è un URL, non un file: Zapier passa ad Airtable il link PDF4me e Airtable lo scarica, motivo per cui non è necessario un passaggio di caricamento separato. Inoltre, Append attachments impostata su False sostituisce il contenuto del campo Document, quindi rieseguendo una riga si sovrascrive il documento anziché crearne delle copie.
Zapier will warn you about a loop here, and it is right to.Questo passaggio scrive nella tabella su cui si attiva lo Zap, quindi in linea di principio il suo stesso aggiornamento potrebbe riattivare lo Zap. Tuttavia, non lo fa perché l'aggiornamento imposta Status su Generated e il filtro nel passaggio 2 lascia passare solo New. Se in futuro dovessi rimuovere tale filtro, rileggi prima questo passaggio.
Passaggio 5: Come si invia la ricevuta al debitore?
Flusso finora: tutto attraverso l'aggiornamento del record.
- Aggiungi Gmail > Send Email.
- Specificare:
- To: la colonna Email dal trigger
- Subject:
Your Swiss QR billpiù il Title - Body type:
Html - Body: un breve saluto che indica il debitore, la fattura e l'importo
- Attachments: l' File Url dal passaggio 3
Configurazione Send Email
Il destinatario proviene dalla fila, quindi ogni debitore riceve il proprio tagliando e nessuno tiene una lista di distribuzione.
Utilizza Amount Text nel corpo dell'email anziché la colonna "Importo" grezza. Non costa nulla e garantisce che la cifra nell'email corrisponda a quella sulla ricevuta, un tipo di discrepanza che il cliente nota ma che tu non percepisci.
Esegui Zap e verifica
- Publish lo Zap.
- Aggiungi una riga alle
Swiss QR Requestscon un creditore, un debitore, un importo, un QR-IBAN e StatusNew. - Attendi il risultato del sondaggio, poi apri Zap Run. Tutti e cinque i passaggi dovrebbero essere verdi.
- Apri la riga:
Documentdovrebbe contenere la ricevuta,Statusdovrebbe essereGenerated. - Apri la ricevuta e controlla che la parte relativa alla fattura e al pagamento riporti lo stesso conto, la stessa causale e lo stesso importo.
- Controlla la casella di posta del debitore.
- Ora aggiungi una riga con Status
Generatede verifica che lo Zap si fermi al passaggio 2. Questo è il test che la maggior parte delle persone salta, ma è quello che dimostra il funzionamento del filtro.
Nell'esecuzione registrata, la versione 1 di Zap è stata completata con successo il 23 ottobre 2026 alle 23:31:53, generando una ricevuta per INV-2003 pagabile a Muster AG di Zuerich per CHF 100.50.
What did you actually build?Un generatore di ricevute di pagamento con un meccanismo di sicurezza. I dati rimangono nel database modificato dal tuo team, la ricevuta viene allegata al record che l'ha generata e un singolo campo decide cosa viene emesso. Nessuno apre il portale bancario e nessuno invia la stessa fattura due volte.
Varianti comuni che puoi aggiungere senza dover ricostruire
Come si confronta questo con la creazione dello stesso flusso in Make
Abbiamo pubblicatothe same scenario in Make Il giorno prima: stessa base, stessa azione PDF4me, stesso risultato. Le differenze stanno tutte nel modo in cui la piattaforma ti fa pronunciare le parole.
| Confronto | In fase Make | In questo Zap |
|---|---|---|
| Filtraggio delle righe rispetto a questo Zap | Una formula sul grilletto, gratuita | Un passaggio di filtro, che consuma un'attività per ogni riga vista |
| Pulizia dell'IBAN e dell'importo rispetto a questo Zap | replace() e formatNumber() all'interno del modulo | Due campi formula di Airtable le mappe Zap |
| Allegare il file rispetto a questo Zap | Un modulo separato per caricare un allegato contenente byte | Un File Url scritto direttamente nel campo degli allegati |
| Questo Zap | 5 moduli, logica suddivisa tra trigger e moduli | 5 passaggi, logica suddivisa tra Airtable e il filtro |
Domande frequenti
Che cos'è una banconota QR svizzera?
La fattura QR svizzera è la ricevuta di pagamento che ha sostituito i vecchi moduli arancioni e rossi in Svizzera. Contiene un codice QR con i dati del creditore, del debitore, l'importo e il riferimento, che il pagatore può scansionare con l'app della propria banca anziché digitare alcunché.
Ha due metà, una parte di ricevuta e una di pagamento, separate da una linea di taglio, e il layout è fissato daSwiss implementation guidelines published by SIX Generarne uno è un problema di specifica, non di progettazione.
Qual è il codice QR-IBAN in Svizzera?
Il QR-IBAN è un secondo numero di conto che la banca rilascia in aggiunta al normale IBAN, riconoscibile perché il suo identificativo istituzionale rientra in un intervallo riservato. Indica alla banca che un pagamento in entrata è accompagnato da un codice QR strutturato, consentendo così l'associazione automatica del pagamento alla fattura corrispondente.
Per questo Zap la regola è semplice: se Reference Type è QRR, il campo IBAN deve contenere il QR-IBAN. Mescolarli produce una ricevuta che viene scansionata come errore.
Airtable è in grado di creare fatture?
Non si tratta di dati pagabili. Airtable conserva i dati e può disporli in un'interfaccia o in una visualizzazione stampabile, ma non può generare un codice QR per una specifica di pagamento e non ha modo di convalidare ciò che ha prodotto.
Il suo punto di forza qui è quello di fungere da registro e, tramite campi formula, da luogo in cui i dati vengono ripuliti. Zap li trasforma in qualcosa che rispetta lo standard e restituisce il risultato.
Perché il mio filtro Zapier non funziona?
Nella maggior parte dei casi, il valore non corrisponde come pensi. Exactly matches confronta l'intera stringa, comprese le maiuscole e gli spazi finali, quindi new, New e NEW non corrispondono a New.
Apri il pannello di test del filtro e leggi la riga "Elementi non corrispondenti". Vengono visualizzati il campo e il valore effettivamente rilevato Zapier, il che di solito è sufficiente per individuare immediatamente la differenza. Trasformando la colonna Airtable in una selezione singola, il problema viene risolto definitivamente.
Risoluzione dei problemi
Leggi ilItems that didn't match riga nel pannello di test del filtro: specifica il campo e il valore. Solitamente la colonna Status contiene qualcosa di diverso da esattamenteNew, oppure il grilletto è stato azionato su una riga prima che qualcuno lo impostasse.
Il passaggio 4 non imposta Status, oppure lo imposta su un valore che il filtro continua a superare. L'aggiornamento e il filtro sono un unico meccanismo: se non concordano, lo Zap può rielaborare il proprio output. Controllali insieme, non separatamente.
Airtable recupera il file dall'URL che gli fornisci, quindi l'URL deve essere raggiungibile quando Airtable lo richiede. Conferma le mappe del passaggio 4File Url dal passaggio PDF4me e non da qualche altro campo, e verifica che l'ID del record provenga dal trigger.
Il filtro viene eseguito su ogni riga rilevata dal trigger, quindi le righe che vengono rifiutate comportano comunque un costo. Se la tabella riceve molto traffico che non dovrebbe mai essere fatturato, assegna allo Zap una vista che contenga solo le righe candidate anziché l'intera tabella.
Prossimi passi
La maggior parte delle automazioni fallisce sulle righe che non si intendeva elaborare, non su quelle che si intendevano elaborare. Di solito, basta un campo e un passaggio per risolvere il problema.