Automatia
Cerca
Contatti

Integrazione Fatture in Cloud con gestionale, negozio online e Stripe, e dove si ferma l'API

Per chi usa Fatture in Cloud e vuole che ordini, clienti e pagamenti arrivino da un altro programma: cosa fa l'API, cosa non permette e quanto lavoro regge.

Team Automatia · pubblicata il · 9 minuti di lettura

Schema di una fattura creata con le Fatture in Cloud API: pagamento, cliente, documento, verifica dell'XML, invio allo SdI ed esito.
Ogni fattura nasce in Fatture in Cloud dai dati del collegamento, mai da un XML fatto altrove, e l'esito dello SdI arriva con un webhook che porta solo l'identificativo.

In breve. Con le Fatture in Cloud API clienti e documenti arrivano da gestionale, negozio online o Stripe, e Fatture in Cloud genera l'XML e lo invia allo SdI: un XML fatto altrove non passa. Le API sono in ogni piano, l'invio allo SdI solo in quelli a pagamento. Pesano poi i tetti del piano e le quote di richieste.

Fatture in Cloud, il programma di fatturazione online di TeamSystem, ha un'API pubblica per collegarlo a negozi online, gestionali, CRM e strumenti come Zapier. Dallo stesso gruppo viene Danea Easyfatt, che si installa sul computer e scambia i dati a file, senza un'API documentata da chiamare: per quello c'è la guida sull'integrazione di Danea Easyfatt.

Qui si guarda cosa può fare un collegamento con Fatture in Cloud, dove si ferma e quali regole del produttore pesano su tempi e costi. Gli altri programmi sono confrontati nella guida al collegamento dei programmi di fatturazione, con schede a parte per i gestionali Zucchetti e per DATEV Koinos; le basi sono nella guida alle API.

Cosa fanno le Fatture in Cloud API, e cosa lasciano fuori

Le Fatture in Cloud API leggono e scrivono quasi tutto quello che si fa nel programma, dentro le regole del piano dell'azienda:

  • clienti, fornitori, prodotti e magazzino;
  • documenti emessi di ogni tipo, dalle fatture ai DDT, dai preventivi alle autofatture;
  • documenti ricevuti, corrispettivi, F24, prima nota e archivio;
  • fattura elettronica, con verifica dell'XML, invio allo SdI e stato;
  • impostazioni come conti di pagamento e aliquote IVA, e le sottoscrizioni dei webhook.

La versione in uso, Fatture in Cloud API v2, è un'API REST descritta da una specifica OpenAPI pubblica, la 2.1.8 al 9 novembre 2026.

Restano fuori alcune cose. Le fatture dei fornitori ferme in «Da registrare» si leggono, ma non si registrano via API. Le API non supportano la modalità commercialista. Una funzione che il piano non comprende manca anche nelle API (pagina sull'attivazione). La più importante, l'XML composto da un altro software, ha la sezione che segue.

Gli SDK di Fatture in Cloud coprono otto linguaggi, tra cui PHP, Python e Java, e hanno licenza MIT; non sono obbligatori, perché basta un qualunque client HTTP.

Chi genera la fattura elettronica e perché un XML esterno non passa

La fattura elettronica la genera sempre Fatture in Cloud, dai dati del documento creato nel programma o con le API. Un XML fatto da un gestionale non si manda allo SdI attraverso Fatture in Cloud (guida sugli XML generati altrove), e le API, che lavorano con dati in JSON, non accettano il caricamento di un file XML.

Si possono importare XML in Fatture in Cloud solo come storico, con un archivio ZIP, e da lì non partono per lo SdI. Per mandarli allo SdI si traducono i campi dell'XML nei dati dell'API, oppure il gestionale crea il documento direttamente: il file per lo SdI lo rifà comunque Fatture in Cloud.

Alcuni dettagli fermano spesso le prime prove (pagina degli errori):

  • il documento non prende da solo i dati dell'anagrafica: partita IVA, codice fiscale, indirizzo, codice destinatario o PEC vanno nella fattura anche se il cliente è già registrato (domande frequenti del produttore);
  • Fatture in Cloud arrotonda a due decimali gli importi di righe e pagamenti prima di ogni calcolo, e se il negozio arrotonda in un altro modo la creazione si ferma con l'errore «Il totale dei pagamenti non corrisponde al totale da pagare»: un metodo dell'API calcola i totali prima;
  • numeri e date vanno in ordine: dopo la fattura 5 del 20 marzo la 6 non può avere la data del 19, e un numero già usato o un codice fiscale già in anagrafica danno un errore di conflitto.

Le correzioni vanno fatte prima, perché un documento già inviato allo SdI di solito risulta bloccato. L'API verifica l'XML, e l'opzione dry_run prova l'invio senza mandare niente. Dopo, lo stato sta nel campo ei_status (inviata, scartata, non consegnata, accettata e altri) e per uno scarto un metodo restituisce il motivo (gestione delle fatture elettroniche).

I tetti del piano su documenti e anagrafiche

Ogni piano di Fatture in Cloud ha un tetto di documenti all'anno e uno di anagrafiche, e le API li rispettano come il programma: oltre il tetto, ogni nuova creazione di quel tipo dà errore. Il tetto dei documenti si azzera ogni anno, quello di clienti, fornitori e prodotti conta tutto l'archivio (guida alla gestione del piano).

I tetti dei piani di Fatture in Cloud al 9 novembre 2026, dalla pagina dei piani del produttore. I documenti sono quelli emessi più quelli ricevuti, dal 1° gennaio al 31 dicembre.
PianoDocumenti all'annoClienti, fornitori e articoli
Forfettari100500
Standard100500
Premium4001.000
Premium Plus8002.500
Complete3.0005.000

Un esempio con numeri tondi: un negozio che fattura ogni ordine, con 15 ordini a settimana, emette circa 780 fatture l'anno, e con qualche decina di fatture dei fornitori supera gli 800 documenti del Premium Plus. Per non scoprirlo con le fatture ferme, il collegamento chiede all'API il piano e l'uso dei tetti, e avvisa in tempo per passare al piano superiore.

Quote di richieste e cosa succede quando finiscono

Le quote contano le richieste fatte in cinque minuti, in un'ora e in un mese; finita una quota, l'API risponde con un errore e indica quanti secondi aspettare. Sono uguali in tutti i piani. Un'app privata, creata dall'azienda per sé, usa la quota dell'azienda, condivisa da tutte le sue app private; un'app pubblica, come quelle dell'App Store, ne ha una sua per ogni azienda.

Le quote delle API di Fatture in Cloud al 9 novembre 2026 (limiti e quote). Quelle dell'ora e del mese si alzano solo su richiesta motivata, quella dei 5 minuti no.
FinestraRichiesteChi la condivideOltre il limite
5 minuti, scorrevole300Tutte le app e gli utenti dell'aziendaErrore 429, con l'attesa in Retry-After
Ora di orologio1.000Ogni app pubblica per azienda; le app private tutte insiemeErrore 403, con Retry-After
Mese di calendario40.000Come per l'oraErrore 403, con Retry-After, fino al mese successivo

Una prima importazione di 2.000 articoli, una richiesta ciascuno, si divide quindi tra almeno due ore diverse, perché la quota oraria riparte allo scoccare dell'ora, e usa un ventesimo della quota del mese. Quanto consumano invece i controlli a intervalli lo mostra il calcolo su un mese di 30 giorni nella pagina che spiega cosa sono le API.

Un collegamento fatto bene legge nelle risposte le richieste rimaste, rispetta Retry-After e sul 429 riprova con attese crescenti, come consiglia il produttore. Nel programma le quote si vedono in Impostazioni, Applicazioni collegate.

Webhook di Fatture in Cloud al posto dei controlli continui

Con i webhook è Fatture in Cloud ad avvisare il tuo sistema quando qualcosa cambia. Sono disponibili per tutti, senza autorizzazione preventiva, e gli avvisi seguono lo standard CloudEvents. Gli eventi coprono documenti emessi e ricevuti, stato delle fatture elettroniche, prodotti e giacenze, clienti e fornitori, corrispettivi, prima nota, F24 e archivio.

L'avviso porta solo l'identificativo di ciò che è cambiato: i dati si leggono dopo, con una chiamata che consuma quota solo quando serve. Per le fatture dei fornitori arriva un evento diverso se la registrazione automatica è riuscita o no.

Chi riceve gli avvisi, su un indirizzo HTTPS, segue le indicazioni del produttore:

  • Rispondere subito. L'attesa è breve: l'avviso va in coda e si elabora dopo.
  • Verificare la firma. Ogni avviso porta un token firmato, da controllare con la chiave pubblica del produttore.
  • Scartare i doppioni. La consegna è «almeno una volta»: lo stesso avviso può tornare, e si riconosce dall'identificativo.
  • Non contare sull'ordine. Di rado un avviso arriva dopo uno più recente.

Se il tuo sistema risponde con un errore del server, Fatture in Cloud tenta la consegna fino a quattro volte in tutto, poi lascia perdere l'avviso; una risposta 410 cancella la sottoscrizione. Dal primo errore la sottoscrizione ha una scadenza a dieci giorni, che una risposta di successo annulla. Per questo serve anche un controllo notturno che confronti i documenti dei due lati.

Accessi, permessi e app privata o pubblica

Il collegamento entra nei dati di un'azienda con uno di tre metodi di accesso. Il produttore raccomanda OAuth 2.0 con codice di autorizzazione: chi usa Fatture in Cloud approva i permessi dal suo account, e il token di rinnovo scade un anno dopo l'ultimo uso. Il token manuale non scade ed è pensato per uso privato e script; il flusso per i dispositivi si attiva solo su richiesta.

I permessi si chiedono per area, in sola lettura o con accesso completo, dai clienti alla prima nota (elenco dei permessi), e il produttore chiede di prendere solo quelli che servono. Un utente secondario ha in più i limiti che gli dà l'amministratore.

L'app che un'azienda usa per sé è privata: la usano gli account di una lista, al massimo 20, e secondo il produttore di solito basta anche in produzione. Quella pubblica, per chi distribuisce il collegamento a molti utenti, la approva il team di Fatture in Cloud solo quando è pronta (visibilità delle app), ed è il passo obbligato per l'App Store. Per sviluppare senza toccare i dati veri, il produttore suggerisce un account e un'azienda di prova separati.

Negozio online, Stripe e gestionale, dato per dato

Nei collegamenti più comuni Fatture in Cloud resta il posto dove nascono le fatture, e gli altri programmi gli portano i dati.

Cosa passa nei collegamenti più comuni: per ogni dato un solo programma ha l'ultima parola.
CollegamentoVa a Fatture in CloudTorna indietroDa decidere prima
Negozio onlineCliente e ordine pagato, che diventa fatturaNumero della fattura e stato dello SdI nell'ordineQuando si fattura, e con quale sezionale
StripePagamento riuscito, con la fattura già pagata sul conto StripeNumero della fattura, per rimborsi e note di creditoQuali pagamenti diventano fattura
GestionaleClienti, prodotti e documenti, se comanda il gestionaleFatture ricevute e stati delle fatture elettronicheChi comanda su anagrafiche e prezzi

Per il negozio online il lavoro sta nei dati del cliente e nel momento della fattura; giacenze, codici e ordini doppi li tratta la guida sul collegamento tra negozio online e gestionale. Stripe da solo non manda fatture allo SdI (Stripe e fatturazione elettronica): il documento si crea già pagato, e in quel caso l'API vuole il conto su cui arriva l'incasso (creazione di una fattura).

Con un gestionale le fatture dei fornitori fanno il giro inverso, dall'area «Da registrare» al ciclo passivo (automazione delle fatture passive). Per i bonifici che arrivano dopo, Fatture in Cloud ha una sua riconciliazione degli estratti conto con TS Pay, secondo la pagina dei piani; se gli incassi li abbina già un altro sistema (riconciliazione bancaria automatica), si sceglie quale dei due tiene lo scadenzario.

Quando basta un'app pronta e quando serve un collegamento su misura

Un'app pronta basta quando fa già il passaggio che ti serve, con le tue regole e i tuoi volumi: prima di costruire si guarda nell'App Store del produttore e si valuta se basta collegare Fatture in Cloud con Zapier.

Basta un'app pronta o ZapierConviene il collegamento su misura
Collega due programmi che l'app prevede giàPiù canali scrivono nello stesso Fatture in Cloud
Ogni ordine diventa una fattura, con regole standardI clienti vanno riconosciuti tra negozio, gestionale e CRM
I volumi stanno larghi nelle quotePiù flussi devono stare nella stessa quota dell'azienda
Un errore ogni tanto si sistema a manoOgni errore deve arrivare a chi lo risolve, con il numero del documento

Un'app pubblica dell'App Store non consuma la quota oraria e mensile dei collegamenti privati dell'azienda, ma le 300 richieste ogni cinque minuti le dividono tutti: è uno dei conti da fare quando gli strumenti sono più d'uno. Come scegliere tra uno strumento senza codice e uno sviluppo lo spiega il confronto tra n8n, Make, Zapier e sviluppo su misura.

Come scriviamo e seguiamo il collegamento con Fatture in Cloud

Colleghiamo Fatture in Cloud al negozio online, a Stripe, al gestionale e al CRM, per aziende, studi e professionisti. Un'integrazione Fatture in Cloud fatta da noi mette ogni avviso in coda dopo averne verificato la firma, dosa le richieste sulle quote dell'azienda, tiene un registro di ogni scambio e ogni notte confronta i documenti dei due lati. Lavoriamo così in tutte le integrazioni tra software.

Al collegamento si può aggiungere il resto del giro delle fatture, dagli esiti dello SdI ai solleciti, descritto in fatturazione elettronica e incassi. Quando il produttore cambia versione o regole, l'adeguamento passa dall'assistenza e manutenzione del software.

Se stanno stretti i tetti, il primo passo è un piano più alto di Fatture in Cloud, fino al Complete. Se invece il programma non regge più il lavoro, o servono regole che non prevede, conviene un gestionale su misura: quando lo costruiamo noi, nel lavoro sono compresi il passaggio di tutti i dati da Fatture in Cloud e un gestionale modellato sulla loro struttura.

Quando un'app dell'App Store o un flusso di Zapier fa già quello che ti serve, te lo diciamo già nella prima chiamata. Come lavoriamo è nel metodo, le formule dell'accordo in formule e costi.

Domande frequenti

Le API di Fatture in Cloud si pagano a parte?

No: funzionano con ogni piano, prova gratuita inclusa, e le quote di richieste non cambiano da un piano all'altro (pagina per gli sviluppatori). Cambiano invece le funzioni: quello che il piano non ha, le API non lo danno. L'invio allo SdI via API, anche come prova senza invio, funziona solo nei piani a pagamento (attivazione delle API).

Come collegare WooCommerce a Fatture in Cloud?

Con un'app pronta, se segue già le tue regole, altrimenti con un collegamento su misura tra le API dei due programmi. Prima va sistemato il checkout: tra i campi di serie di WooCommerce mancano codice fiscale, partita IVA, codice destinatario e PEC. Poi con il commercialista si decide quando nasce la fattura e con quale sezionale.

Come collegare Stripe a Fatture in Cloud?

Con gli avvisi di Stripe: a pagamento riuscito il collegamento trova il cliente in anagrafica o lo aggiunge, crea la fattura già pagata sul conto Stripe impostato in Fatture in Cloud e la invia allo SdI. Per i casi semplici può bastare Zapier, che la guida rapida di Fatture in Cloud cita proprio per i pagamenti Stripe. Commissioni e autofattura TD17 le spiega la pagina su Stripe e la fattura elettronica.

Come si esportano i dati e gli XML da Fatture in Cloud?

Dal programma si chiede un archivio ZIP dei documenti, pronto in tempi diversi secondo il piano (pagina dei piani, 9 novembre 2026). Per esportare dati da Fatture in Cloud con l'API, invece, gli elenchi arrivano a pagine di 100 elementi al massimo (guida all'esportazione), e l'XML di ogni fattura elettronica emessa è una richiesta a sé: 3.000 fatture chiedono più di 3.000 richieste, su almeno quattro ore diverse. Per un passaggio completo c'è la migrazione dei gestionali.

Il commercialista può collegarsi alle API con il suo account?

No: le API non supportano la modalità commercialista, quindi con il proprio account lo studio non lavora via API sulle aziende dei clienti. Per un collegamento con il commercialista via API è il cliente a creare un token per la sua azienda, con i permessi che sceglie, e a revocarlo quando vuole da Applicazioni collegate (attivazione delle API). Se lo studio usa un'app privata, gli account autorizzati sono al massimo 20; oltre, il produttore indica l'app pubblica, che approva caso per caso.

Fatture in Cloud funziona con Zapier o Make?

Con Zapier sì: l'integrazione ufficiale è pubblicata, ancora in beta, con una guida rapida del produttore. Ogni azione è una chiamata API che conta nelle quote, e l'innesco «arricchito» fa una lettura in più. Per Make e n8n la documentazione ufficiale non ha guide: prima di usare un modulo, chiedi chi lo mantiene.

Hai un'altra domanda? Scrivici · +39 375 669 3055

Colleghiamo Fatture in Cloud ai vostri programmi

Una prima chiamata, breve e senza impegno: ci dite da dove arrivano ordini, pagamenti e clienti, e vi diciamo se basta un'app pronta o serve un collegamento su misura, e quali limiti del vostro piano pesano.

Società
Automatia S.r.l.Gestionali su misura, automazioni, integrazioni tra sistemi.
Operativi
24 ore su 24, 7 giorni su 7
Lingue
Italiano, inglese o russo
Parliamo di Fatture in Cloud
  1. Ci scrivi
  2. Prima valutazione
  3. Breve chiamata
Scrivici su WhatsApp, al +39 375 669 3055 (si apre in una nuova scheda)