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

> Fatture in Cloud API con gestionale, e-commerce e Stripe: chi genera la fattura elettronica, tetti dei piani, quote di richieste, webhook, accessi.

URL: https://automatia.it/guide/integrazione-fatture-in-cloud
Sezione: Home › Guide › Integrazione Fatture in Cloud
Aggiornato: 2026-11-10
Autore: Automatia S.r.l., software house (https://automatia.it/)

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.

![Schema di una fattura creata con le Fatture in Cloud API: pagamento, cliente, documento, verifica dell'XML, invio allo SdI ed esito.](https://automatia.it/assets/img/tavole/integrazione-fatture-in-cloud-4x3.png?v=c265f392)
*Fig. 1: 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.*

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](https://automatia.it/guide/integrazione-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](https://automatia.it/guide/collegare-il-software-di-fatturazione), con schede a parte per i [gestionali Zucchetti](https://automatia.it/guide/integrazione-zucchetti) e per [DATEV Koinos](https://automatia.it/guide/integrazione-datev-koinos); le basi sono nella [guida alle API](https://automatia.it/guide/api-cosa-sono-integrazione-software).

## 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](https://github.com/fattureincloud/openapi-fattureincloud), 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](https://developers.fattureincloud.it/docs/guides/pending-documents/). Le API non supportano la modalità commercialista. Una funzione che il piano non comprende manca anche nelle API ([pagina sull'attivazione](https://developers.fattureincloud.it/docs/basics/activation/)). La più importante, l'XML composto da un altro software, ha la sezione che segue.

Gli [SDK di Fatture in Cloud](https://developers.fattureincloud.it/docs/sdks/) 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](https://developers.fattureincloud.it/docs/guides/externally-generated-xml/)), 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](https://developers.fattureincloud.it/docs/basics/errors/)):

- 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](https://developers.fattureincloud.it/docs/FAQs/));
- 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](https://developers.fattureincloud.it/docs/guides/invoice-totals/);
- 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](https://developers.fattureincloud.it/docs/guides/e-invoice-management/)).

## 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](https://developers.fattureincloud.it/docs/guides/plan-management/)).

| Piano | Documenti all'anno | Clienti, fornitori e articoli |
| --- | --- | --- |
| Forfettari | 100 | 500 |
| Standard | 100 | 500 |
| Premium | 400 | 1.000 |
| Premium Plus | 800 | 2.500 |
| Complete | 3.000 | 5.000 |

*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.*

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.

| Finestra | Richieste | Chi la condivide | Oltre il limite |
| --- | --- | --- | --- |
| 5 minuti, scorrevole | 300 | Tutte le app e gli utenti dell'azienda | Errore 429, con l'attesa in Retry-After |
| Ora di orologio | 1.000 | Ogni app pubblica per azienda; le app private tutte insieme | Errore 403, con Retry-After |
| Mese di calendario | 40.000 | Come per l'ora | Errore 403, con Retry-After, fino al mese successivo |

*Le quote delle API di Fatture in Cloud al 9 novembre 2026 ([limiti e quote](https://developers.fattureincloud.it/docs/basics/limits-and-quotas/)). Quelle dell'ora e del mese si alzano solo su richiesta motivata, quella dei 5 minuti no.*

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](https://automatia.it/guide/api-cosa-sono-integrazione-software).

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](https://developers.fattureincloud.it/docs/webhooks/), senza autorizzazione preventiva, e gli avvisi seguono lo standard CloudEvents. Gli [eventi](https://developers.fattureincloud.it/docs/webhooks/notification-types/) 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](https://developers.fattureincloud.it/docs/webhooks/notifications/):

- **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](https://developers.fattureincloud.it/docs/webhooks/expiration/), 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](https://developers.fattureincloud.it/docs/basics/authentication/). 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](https://developers.fattureincloud.it/docs/basics/scopes/)), 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](https://developers.fattureincloud.it/docs/basics/create-an-app/)), ed è il passo obbligato per l'[App Store](https://developers.fattureincloud.it/docs/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.

| Collegamento | Va a Fatture in Cloud | Torna indietro | Da decidere prima |
| --- | --- | --- | --- |
| Negozio online | Cliente e ordine pagato, che diventa fattura | Numero della fattura e stato dello SdI nell'ordine | Quando si fattura, e con quale sezionale |
| Stripe | Pagamento riuscito, con la fattura già pagata sul conto Stripe | Numero della fattura, per rimborsi e note di credito | Quali pagamenti diventano fattura |
| Gestionale | Clienti, prodotti e documenti, se comanda il gestionale | Fatture ricevute e stati delle fatture elettroniche | Chi comanda su anagrafiche e prezzi |

*Cosa passa nei collegamenti più comuni: per ogni dato un solo programma ha l'ultima parola.*

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](https://automatia.it/guide/integrare-ecommerce-e-gestionale). Stripe da solo non manda fatture allo SdI ([Stripe e fatturazione elettronica](https://automatia.it/guide/stripe-fatturazione-elettronica-sdi)): il documento si crea già pagato, e in quel caso l'API vuole il conto su cui arriva l'incasso ([creazione di una fattura](https://developers.fattureincloud.it/docs/guides/invoice-creation/)).

Con un gestionale le fatture dei fornitori fanno il giro inverso, dall'area «Da registrare» al ciclo passivo ([automazione delle fatture passive](https://automatia.it/guide/automazione-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](https://automatia.it/guide/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 Zapier | Conviene 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 standard | I clienti vanno riconosciuti tra negozio, gestionale e CRM |
| I volumi stanno larghi nelle quote | Più flussi devono stare nella stessa quota dell'azienda |
| Un errore ogni tanto si sistema a mano | Ogni 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](https://automatia.it/guide/n8n-make-zapier-o-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](https://automatia.it/servizi/integrazioni-api).

Al collegamento si può aggiungere il resto del giro delle fatture, dagli esiti dello SdI ai solleciti, descritto in [fatturazione elettronica e incassi](https://automatia.it/servizi/fatturazione-elettronica-e-incassi). Quando il produttore cambia versione o regole, l'adeguamento passa dall'[assistenza e manutenzione del software](https://automatia.it/servizi/assistenza-e-manutenzione-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](https://automatia.it/servizi/gestionali-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](https://automatia.it/metodo), le formule dell'accordo in [formule e costi](https://automatia.it/formule).

## 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](https://developers.fattureincloud.it/docs/developer-account/)). 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](https://developers.fattureincloud.it/docs/basics/activation/)).

**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](https://developer.woocommerce.com/docs/code-snippets/customising-checkout-fields) 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](https://developers.fattureincloud.it/docs/quickstarts/zapier-quickstart/) di Fatture in Cloud cita proprio per i pagamenti Stripe. Commissioni e autofattura TD17 le spiega la pagina su [Stripe e la fattura elettronica](https://automatia.it/guide/stripe-fatturazione-elettronica-sdi).

**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](https://developers.fattureincloud.it/docs/guides/export-file/)), 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](https://automatia.it/servizi/migrazione-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](https://developers.fattureincloud.it/docs/basics/activation/)). 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](https://developers.fattureincloud.it/docs/quickstarts/zapier-quickstart/) 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.


## Pagine collegate

- [Collegare il software di fatturazione](https://automatia.it/guide/collegare-il-software-di-fatturazione): I programmi di fatturazione usati in Italia secondo come si collegano agli altri: API, servizi che trasmettono l'XML, file, servizi dell'Agenzia.
- [Integrazioni tra software](https://automatia.it/servizi/integrazioni-api): Colleghiamo gestionale, e-commerce, fatturazione, banca e CRM tramite API, file o database, con controlli e avvisi quando un passaggio si blocca.
- [Collegare e-commerce e gestionale](https://automatia.it/guide/integrare-ecommerce-e-gestionale): Cosa sincronizzare tra e-commerce e gestionale, quando basta un plugin, come evitare giacenze sfasate e ordini doppi, e cosa serve per un portale B2B.
- [Fatturazione automatica](https://automatia.it/guide/fatturazione-automatica): Come funziona la fatturazione automatica: i fatti da cui parte la fattura, i termini di legge, gli esiti dello SdI, i controlli e i casi in cui non conviene.

---

Automatia S.r.l. · info@automatia.it · Italia +39 375 669 3055 (WhatsApp sempre attivo, 24 ore su 24, 7 giorni su 7) · Svizzera +41 76 511 26 10 (telefono e WhatsApp) · operativi 24 ore su 24, 7 giorni su 7 · https://automatia.it/contatti
Indice del sito per le AI: https://automatia.it/llms.txt · testo integrale: https://automatia.it/llms-full.txt
