Zapier

Applicazione online che mette in comunicazione diversi applicativi per automatizzare in modo semplice alcune attività.
 

Dato che abbiamo pubblicato l’applicazione di Fattura24 in Zapier, in questa guida spieghiamo le funzionalità di Zapier e come usarlo nello specifico per sfruttare Fattura24.

Con Zapier è possibile creare un documento (ordine, fattura, ricevuta) in Fattura24 e un contatto in rubrica nel momento in cui avviene un’altra azione (detta Trigger) in un’altra app di propria scelta tra quelle disponibili in Zapier.

Step 1 – preparazione

Per utilizzare l’app di Fattura24 in Zapier ti occorre:

• un piano in abbonamento Business attivo su Fattura24;
• l’API KEY associata al tuo piano in abbonamento Business; per ottenerla vai in Configurazione > App e Servizi esterni, clicca sul pulsante Configura di Zapier e richiedi l’API KEY che ti sarà subito mostrata;
• un account in Zapier, per creare l’account registrati a Zapier.

Dopodiché dovrai creare il cosiddetto ZAP. Lo ZAP è un’integrazione singola composta da un Trigger (una causa scatenante) e un’Azione.

Il Trigger andrà scelto tra le app disponibili in Zapier, mentre l’Azione sarà fornita dalla nostra app di Fattura24.

Step 2 – configurazione

Vediamo come creare lo ZAP per collegare Fattura24 a un’altra app.

Nella pagina del tuo account su Zapier clicca sul pulsante MAKE A ZAP:

1. Configura il Trigger:
   1. Ricerca e seleziona l’app con il Trigger che ti interessa;
   2. Seleziona il Trigger tra quelli che fornisce l’app;
   3. Accedi con il tuo account dell’app;
   4. Testa la configurazione del Trigger;
2. Configura l’Azione:
   1. Ricerca e seleziona l’app di Fattura24;
   2. Seleziona un’Azione tra Create or Update Contact e Create Document;
   3. Connettiti al tuo account di Fattura24. Per farlo dovrai inserire la tua API KEY di Fattura24. Se inserisci una API KEY errata riceverai un messaggio di errore;
   4. Nella sezione Edit Template compila i campi con i dati che andranno inviati a Fattura24;
   5. Testa la configurazione dell’Azione;
3. Attiva lo ZAP.

I campi dell’Azione possono essere valorizzati con i valori che restituisce il Trigger. Ad esempio se il Trigger è la creazione di un contatto nella rubrica di Google, allora si possono prendere tutti i dati del contatto creato in Google per valorizzare i campi dell’azione Crea contatto di Fattura24.

Per prendere questi valori, clicca sul pulsante che è a destra di ogni casella di testo ed apparirà una lista dei parametri passati dal Trigger, da cui selezionerai il parametro che ti occorre.

L’utente che crea uno ZAP con Fattura24 dovrà quindi inserire i campi prendendoli dal Trigger.

Tuttavia quando l’app di Fattura24 uscirà dalla fase di test, creeremo noi degli ZAP già impostati che collegano Fattura24 e le app più usate.

Questo semplificherà il lavoro all’utente, che dovrà compilare solo in parte (o non dovrà compilare) la sezione Edit Template.

Step 3 – verifica

Per verificare il funzionamento, esegui il Trigger che hai scelto e verifica se viene effettuata in automatico l’Azione.

Nella versione gratuita, Zapier controlla ogni 15 minuti se è stato eseguito un Trigger. Se è così, Zapier effettua l’Azione.

Con degli esempi descriviamo più in dettaglio le azioni Crea contatto e Crea documento e la compilazione dei campi:

• Fattura24 e Shopify con Zapier: clicca qui;
• Fattura24 e Stripe con Zapier: clicca qui;
• Fattura24 e vTiger con Zapier: clicca qui;
• Fattura24 e Google Contacts con Zapier: clicca qui;
• Fattura24 e Google Sheets con Zapier: clicca qui;
• Fattura24 e ClickFunnels con Zapier clicca qui;
• Fattura24 e PayPal con Zapier clicca qui;
• Fattura24 e Amazon con Zapier: clicca qui;
• Fattura24 e eBay con Zapier: clicca qui;
• Fattura24 e Saleforce con Zapier: clicca qui;
• Fattura24 e InfusionSoft con Zapier: clicca qui;
• Fattura24 e QuickBook con Zapier: clicca qui;
• Fattura24 e MailChimp con Zapier: clicca qui;

Create Document – linee guida

Qui sotto indichiamo una serie di campi e condizioni di cui tenere conto quando si scatena l’azione Create Document, soprattutto in funzione della fatturazione elettronica.

Come creare un corrispettivo giornaliero

Dal 23/02/2021 è stata aggiunta una nuova azione: Create new Fee.

Con questa funzione si può creare, nel gestionale Fattura24, un corrispettivo giornaliero utilizzando Zapier.

È obbligatorio compilare tutti i campi dell’azione, tranne PaymentMethodName e PaymentMethodDescription.

Gli step 1 e 2 della configurazione rimangono inalterati. Analogamente a quanto spiegato nel paragrafo successivo, è possibile inserire uno o più passaggi intermedi tra l’azione iniziale e Fattura24, qualche esempio non esaustivo:

• esempio 1: un Formatter per convertire il formato dei numeri e cambiare il separatore dei decimali;
• esempio 2: un Formatter per creare più righe attraverso il line_itemizer.

Per una guida sul funzionamento di questi step intermedi si può fare riferimento allo ZAP di esempio che integra Google Sheets con il Formatter e Fattura24, facendo click qui per accedere alla funzione da dentro il vostro account su Zapier.

Uno step in più

Negli scenari più comuni siamo abituati a pensare che con Zapier si possano mettere in comunicazione due applicazioni per volta.

Mentre facciamo i test ci possiamo rendere conto che non sempre tutto è così semplice né così immediato come vorremmo.

Facciamo qualche esempio pratico: quanti modi conoscete per scrivere una data? Simile tema di complessità anche per gli importi: siamo abituati dai computer a gestire il punto come separatore dei decimali, molto meno a immaginare la virgola per delimitare le migliaia.

Per far fronte a situazioni di questo genere può essere opportuno inserire uno o più passaggi intermedi alla nostra azione Zapier ce ne offre alcuni già pre-impostati:

• Paths;
• Filter:
• Delay;
• Formatter;
• Schedule.

Ne vediamo un paio a titolo esemplificativo ma non esaustivo.

Il primo strumento è il Formatter (documentazione in inglese) che grazie a questo possiamo convertire una data o un numero nel formato che desideriamo (tra quelli che si possono scegliere in un menu a tendina), manipolare un testo – ad esempio troncarne una parte – e così via.

Grazie a Filter, invece, possiamo inserire delle condizioni prima di mandare avanti il processo e di arrivare allo step finale; da ultimo, può farci molto comodo Delay, volendo anche in abbinamento con Schedule: possiamo programmare giorni e orari per le nostre azioni, nonché stabilire un intervallo di tempo tra una e l’altra.

Nella documentazione di Zapier che trovate cliccando qui potrete sicuramente approfondire al meglio!

Risoluzione dei problemi

Esempio: hai creato un’azione Crea Documento in Fattura24, esegui un test.

Ottieni come risultato un messaggio di errore, con una schermata simile a quella che puoi vedere qui sotto:

Come prima cosa leggi attentamente il messaggio di errore, a volte contiene indicazioni utili.

Ecco un elenco di casi in cui si può presentare un messaggio di errore specifico:

• i campi Total Vat Amount e Product Vat Value sono vuoti;
• Document Date e Date contengono due date identiche;
• il formato immesso per i campi Date e Document Date non è AAAA–MM–GG;
• i campi CustomerFiscalCode e CustomerVatCode sono vuoti;
• è stato selezionato il tipo di documento FE ed impostato SendEmail su Yes;
• è stato selezionato il tipo di documento FE mentre il campo Payment Method Options è vuoto;
• è stato selezionato il tipo di documento FE mentre il campo Payment Method Options corrisponde a Bonifico e il campo Payment Method Description è vuoto;
• è stato selezionato il tipo di documento FE mentre il valore del campo Product Vat Value è 0 e il campo Product Vat Nature è vuoto;
• è stato selezionato il tipo di documento FE mentre il campo Product Vat Nature non è vuoto e il campo Product Vat Value è vuoto;
• è stato compilato il campo Shipping Amount e lasciato vuoto Shipping Vat Value (o l’inverso);
• è stato compilato il campo Shipping Vat Value e lasciato vuoto Shipping Vat Includes Taxes;

In tutti gli altri casi in cui il messaggio di errore non suggerisce nulla c’è a disposizione il servizio di ticketing di Fattura24 (che si può inviare all’interno del proprio account in Fattura24) con il quel è possibile inviarci un formato testo (txt va benissimo) con i dati inseriti nei vari campi dell’azione in occasione dell’ordine che ha scatenato l’errore.

Con i dati che riceveremo proveremo ad inserire dei dati simili per riprodurre il messaggio e indagare sulla causa.

Se non riusciamo e l’errore persiste ti consigliamo di far click sulla scritta Contact Support per inoltrare una segnalazione all’assistenza di Zapier che sarà in grado di fornirci il tracciato che ci consentirà di approfondire.

Per qualsiasi altra informazione non esitare a contattare il nostro Staff al numero in calce a questa pagina.

Il nostro team tecnico è a tua completa disposizione per permetterti di ottenere il meglio da Fattura24.

Limiti di utilizzo

Questo modulo utilizza le API di Fattura24. e per questo motivo dovrai tenere in considerazione i limiti di utilizzo delle nostre API:

1. non più di 30 chiamate al minuto;
2. non più di 200 chiamate l’ora;
3. non più di 500 chiamate ‘nelle ultime 24 ore;

A titolo puramente esemplificativo la creazione di un singolo documento fattura corrisponde ad una chiamata.

Per avere maggiori informazioni su questi valori contatta la nostra assistenza clienti.