# Collegare il programma di fatturazione, online o installato, con le API o con i file XML

> API per la fatturazione elettronica e file XML: come si collegano Fatture in Cloud, Aruba, Danea Easyfatt, Zucchetti e DATEV Koinos, e cosa passa.

URL: https://automatia.it/guide/collegare-il-software-di-fatturazione
Sezione: Home › Guide › Collegare il software di fatturazione
Aggiornato: 2026-11-11
Autore: Automatia S.r.l., software house (https://automatia.it/)

Per chi deve far lavorare il programma di fatturazione con il gestionale, il negozio online o lo studio del commercialista: chi ha API, chi lavora a file, cosa passa.

![Schema delle API per la fatturazione elettronica e delle altre strade: API del programma, scambio di file, invio dell'XML, canali dello SdI.](https://automatia.it/assets/img/tavole/collegare-il-software-di-fatturazione-4x3.png?v=f975926b)
*Fig. 1: Quattro strade intorno allo stesso file: con le API la fattura nasce nel programma di fatturazione, con l'invio dell'XML la compone il gestionale e un servizio la trasmette.*

Con le API per la fatturazione elettronica un gestionale crea le fatture nel programma di fatturazione e, se il programma lo permette, le manda allo SdI. Fatture in Cloud e DATEV Koinos fanno tutte e due le cose, Fattura24 solo la prima; Aruba e il Digital Hub di Zucchetti trasmettono l'XML composto dal gestionale; Danea Easyfatt scambia file.

Tutti i programmi di fatturazione producono per lo SdI lo stesso file XML, ma ognuno si apre agli altri programmi a modo suo. Da questo dipende cosa può fare un collegamento: creare le fatture dal gestionale, portarci gli ordini del negozio online, farle arrivare al commercialista senza esportazioni a mano.

Qui trovi i casi più comuni, con le fonti consultate il 9 novembre 2026. I programmi sono citati per nome come esempi, senza accordi con i loro produttori; se parti da zero, le parole tecniche sono spiegate in [cosa sono le API](https://automatia.it/guide/api-cosa-sono-integrazione-software).

## Le API per la fatturazione elettronica e gli altri modi di collegarsi

Un programma di fatturazione si collega agli altri in quattro modi, e spesso ne offre più d'uno.

- Con le sue API: il gestionale manda cliente, righe e pagamento, e il programma crea la fattura con la sua numerazione. Fatture in Cloud e SuperBill di DATEV Koinos la mandano anche allo SdI; le API di Fattura24 la creano soltanto.
- Con un servizio che trasmette l'XML già pronto: il file lo compone il gestionale, il servizio lo manda allo SdI e ne segue l'esito. Lo fanno i web service di Aruba, il Digital Hub di Zucchetti e IntegraSDI di DATEV Koinos, che per i caricamenti a mano ha anche XML Express.
- Con i file: il programma esporta e importa documenti, clienti e articoli in XML o in Excel. È la strada di Danea Easyfatt, che si installa su Windows.
- Con i canali dello SdI, senza un servizio di mezzo: la PEC, oppure SdICoop e SdIFtp, che chiedono un accreditamento ([documentazione del Sistema di Interscambio](https://www.fatturapa.gov.it/it/norme-e-regole/DocumentazioneSDI/)). Dal portale «Fatture e Corrispettivi» dell'Agenzia delle Entrate la fattura si prepara e si trasmette a mano, gratis.

Le prime due strade sono le API per la fatturazione elettronica in senso stretto, e la differenza tra loro decide quasi tutto il resto: chi numera le fatture, chi applica le regole fiscali, cosa torna indietro.

## Chi crea la fattura, il gestionale o il programma di fatturazione

La prima scelta è dove nasce la fattura: nel programma di fatturazione, che riceve i dati, o nel gestionale, che compone l'XML e lo affida a un servizio che lo trasmette.

| Il programma crea la fattura | Il gestionale compone l'XML |
| --- | --- |
| Il gestionale manda cliente, righe e pagamento | Il gestionale scrive il file XML completo |
| Numero e serie li assegna il programma | Numero e serie li assegna il gestionale |
| Le regole fiscali sono quelle che il programma conosce | Nature IVA, bollo e ritenute le scrive il gestionale |
| Tornano numero, PDF ed esito dello SdI | Il servizio trasmette e riporta l'esito |

La prima strada conviene quando l'amministrazione lavora già nel programma di fatturazione e vuole trovarci tutte le fatture, ma il collegamento fa solo quello che le API del programma prevedono. Quelle di Fattura24, per esempio, creano la fattura elettronica nell'account senza mandarla allo SdI ([creare una fattura elettronica](https://www.fattura24.com/api/crea-fattura-elettronica/)); nella versione 0.3.3 non modificano i documenti e non fanno fatture con casse previdenziali e ritenute, come le parcelle con la ritenuta d'acconto ([introduzione alle API](https://www.fattura24.com/api/introduzione/)).

La seconda conviene quando le fatture nascono già complete nel gestionale, da contratti, DDT o pagamenti, e serve solo un canale verso lo SdI. Allora ogni dettaglio del file tocca al gestionale, e la numerazione sta in un posto solo: due programmi sulla stessa serie danno, prima o poi, lo stesso numero a due fatture.

## I programmi più comuni e come si collegano

Ogni software di fatturazione elettronica documenta a modo suo come si apre agli altri; per quattro di loro il nome porta a una guida dedicata.

| Programma | Dove gira | Come si collega | Cosa passa |
| --- | --- | --- | --- |
| [Fatture in Cloud](https://automatia.it/guide/integrazione-fatture-in-cloud) | Online | API pubblica, versione 2, con accesso OAuth 2.0 o con un token ([documentazione per sviluppatori](https://developers.fattureincloud.it/docs/basics/authentication/)) | Clienti, fornitori, prodotti, documenti emessi e ricevuti, invio e stato della fattura elettronica, prima nota |
| Aruba Fatturazione Elettronica | Online | Web service per le utenze Premium ([documentazione di Aruba](https://fatturazioneelettronica.aruba.it/apidoc/docs.html)) | XML composti dal gestionale, fatture inviate e ricevute, notifiche dello SdI |
| [Danea Easyfatt](https://automatia.it/guide/integrazione-danea-easyfatt) | Programma per Windows; Easyfatt Cloud dal browser | File [Easyfatt-Xml](https://www.danea.it/software/easyfatt/xml/) ed Excel; per l'e-commerce un protocollo di Danea | Documenti, clienti, fornitori e prodotti; ordini dal sito, catalogo verso il sito |
| [Gestionali Zucchetti](https://automatia.it/guide/integrazione-zucchetti) | Dal programma installato al cloud, secondo il prodotto | Dipende dal prodotto e dall'installazione; per le fatture il [Digital Hub](https://www.zucchetti.it/it/cms/soluzioni/obblighi-normativi/fatturazione-elettronica/digital-hub/fatturazione-elettronica-aziende-descrizione.html) | Fatture emesse e ricevute, notifiche, conservazione |
| [DATEV Koinos](https://automatia.it/guide/integrazione-datev-koinos) | Online | API in un [portale pubblico per sviluppatori](https://developer.datev.it/), con OAuth 2.0, OpenID Connect e la chiave della licenza | Anagrafiche, articoli, documenti, invio allo SdI, incassi |
| Fattura24 | Online | API su HTTPS con una chiave d'accesso | Contatti, ordini, ricevute, fatture e il loro PDF; l'invio allo SdI si fa dal programma |
| Servizi gratuiti dell'Agenzia delle Entrate | Portale web, programma per PC, app FatturAE | A mano dal portale o dall'app; il programma per PC prepara il file, che si trasmette dal portale o via PEC ([software e app](https://www.agenziaentrate.gov.it/portale/aree-tematiche/fatturazione-elettronica/guida-fatturazione-elettronica/i-servizi-dell-agenzia-fe/sw-stand-alone-e-app)) | Preparazione, controllo e invio delle fatture, consultazione, conservazione su adesione |

*Dalla documentazione consultata il 9 novembre 2026: prima di un collegamento si ricontrolla la versione installata.*

Nella tabella la colonna che pesa di più è la seconda. Un programma online risponde quando il gestionale lo chiama; uno installato su un computer dell'ufficio di solito no, e il collegamento deve passare da quel computer. Con Danea Easyfatt, per esempio, è il programma a cercare gli ordini sul sito, e accanto gli serve un piccolo programma che scambi i file e ne controlli codici e totali: i vincoli che Danea documenta, versione per versione, sono nella guida all'[integrazione di Danea Easyfatt](https://automatia.it/guide/integrazione-danea-easyfatt).

## Il tracciato XML della fattura elettronica, comune a tutti i programmi

Il tracciato XML della fattura elettronica è uguale per tutti i programmi: lo fissano le [specifiche tecniche dell'Agenzia delle Entrate](https://www.agenziaentrate.gov.it/portale/specifiche-tecniche-versione-1.9.1-%C2%A0-utilizzabili-dal-15-maggio-2026-) e lo descrive il sito [FatturaPA](https://www.fatturapa.gov.it/it/norme-e-regole/documentazione-fattura-elettronica/formato-fatturapa/), che ne pubblica anche una rappresentazione in tabella, in Excel. Per questo l'XML è il punto d'incontro più sicuro tra due programmi che non si conoscono.

Un file contiene una fattura o un lotto di fatture, più file viaggiano insieme in un archivio ZIP e ogni nome porta l'identificativo fiscale di chi trasmette ([specifiche del Sistema di Interscambio](https://www.fatturapa.gov.it/export/documenti/Specifiche-tecniche-relative-al-Sistema-di-Interscambio-versione-1.8.4.pdf)).

Formato comune, però, non vuol dire che ogni programma accetti un XML fatto da un altro.

| Servizio | XML fatto altrove | Come |
| --- | --- | --- |
| Aruba Fatturazione Elettronica | Sì | Con i web service, anche se il file è già firmato |
| Digital Hub di Zucchetti | Sì, anche dai gestionali di altri produttori | Con un web service o, per volumi molto alti, intorno ai 200.000 documenti l'anno, con un'area SFTP |
| XML Express e IntegraSDI di DATEV Koinos | Sì, «qualunque sia l'applicativo» | In [XML Express](https://www.superbill.it/xml-express/) si caricano a mano, anche a lotti; con le API di [IntegraSDI](https://developer.datev.it/Docs/IntegraSDI) li manda il programma, se ha un accordo di servizio |
| Portale «Fatture e Corrispettivi» | Sì | Controlla e trasmette i file preparati con altre procedure, a mano ([procedura web](https://www.agenziaentrate.gov.it/portale/aree-tematiche/fatturazione-elettronica/guida-fatturazione-elettronica/i-servizi-dell-agenzia-fe/la-procedura-web-fe)) |
| Fatture in Cloud | No | Si importa come archivio, senza invio; per mandarla allo SdI il documento si ricrea con le API ([XML generati altrove](https://developers.fattureincloud.it/docs/guides/externally-generated-xml/)) |

*Chi trasmette allo SdI un XML composto da un altro programma, al 9 novembre 2026.*

## Cosa passa da un programma all'altro

Ogni dato ha un programma che comanda e uno che lo legge; quelli che contano sono quasi sempre questi.

- **Clienti e fornitori.** L'anagrafica nasce in un posto solo. Prima di fatturare, codice fiscale e partita IVA si controllano anche con i servizi in forma di API del [catalogo dell'Agenzia delle Entrate](https://www.agenziaentrate.gov.it/portale/catalogo-dei-servizi-di-interoperabilita/che-cos-enti), aperti a chi ha una partita IVA attiva ([provvedimento del 4 aprile 2023](https://www.agenziaentrate.gov.it/portale/-/provvedimento-del-4-aprile-2023)).
- **Articoli e listini.** Codici, descrizioni, prezzi e aliquote: se il magazzino sta nel gestionale, il programma di fatturazione li riceve e non li cambia.
- **Ordini e DDT.** Diventano documenti nel programma, o righe di una fattura che il gestionale compone, come la [fattura differita](https://automatia.it/guide/fattura-differita-ddt) di fine mese. Per la fatturazione elettronica con WooCommerce o un altro negozio vale lo schema descritto per [integrare e-commerce e gestionale](https://automatia.it/guide/integrare-ecommerce-e-gestionale).
- **Fatture emesse.** Al gestionale tornano numero, data, PDF ed esito dello SdI; uno scarto arriva a chi deve correggere.
- **Fatture dei fornitori.** Dal canale che le riceve vanno al gestionale, per l'abbinamento con ordini e scadenze, come nell'[automazione delle fatture passive](https://automatia.it/guide/automazione-fatture-passive).
- **Incassi.** Il pagamento trovato in banca chiude la fattura in tutti e due i programmi, con la [riconciliazione bancaria automatica](https://automatia.it/guide/riconciliazione-bancaria-automatica).

## Come arrivano le fatture al commercialista

Per inviare le fatture elettroniche al commercialista ogni programma ha una strada sua, da scegliere con lo studio, perché conta anche il programma che usa lui. Le strade sono tre: esportare le fatture elettroniche del periodo in un archivio, dare allo studio un accesso, oppure appoggiarsi a un servizio che lo studio usa già.

| Programma | Come arrivano le fatture allo studio |
| --- | --- |
| Danea Easyfatt | Un archivio ZIP del periodo, con gli XML o in PDF, oppure la connessione che lo studio chiede in TS Digital, il servizio di TeamSystem per le fatture di Easyfatt ([manuale di Easyfatt](https://help.danea.it/easyfatt/Collegamento_con_il_commercialista.htm)) |
| Fatture in Cloud | Un token che l'azienda crea per lo studio e può revocare, perché le API non hanno un accesso da commercialista ([attivazione delle API](https://developers.fattureincloud.it/docs/basics/activation/)) |
| DATEV Koinos | Con XML Express, uno spazio web comune, se anche lo studio è cliente del produttore |
| Programmi Zucchetti | Il Digital Hub dello studio, con le credenziali «Subfornitura» che lo studio fornisce ([Digital Hub](https://www.zucchetti.it/it/cms/soluzioni/obblighi-normativi/fatturazione-elettronica/digital-hub/fatturazione-elettronica-aziende-descrizione.html)) |

*Quattro programmi e lo studio del commercialista, dalla documentazione dei produttori consultata il 9 novembre 2026: la strada si sceglie con lo studio.*

Il passaggio meno standard è la prima nota: i programmi degli studi la importano con tracciati loro, che non sempre sono pubblici. [Il tracciato si chiede allo studio](https://automatia.it/guide/gestionale-e-commercialista#esportare-la-prima-nota-nel-formato-dello-studio), e il collegamento prepara i file esattamente in quella forma.

## Licenze, quote di richieste e ambienti di prova

Prima di un collegamento si controllano tre cose: cosa permette il piano o la licenza, quante richieste accetta il programma e dove si prova senza toccare le fatture vere.

Le API di Aruba per la fatturazione elettronica sono riservate alle utenze Premium e alle utenze base collegate con una delega, e hanno un ambiente di prova che simula lo SdI ([documentazione di Aruba](https://fatturazioneelettronica.aruba.it/apidoc/docs.html)). Negli altri casi il vincolo cambia nome ma non sostanza: in Fatture in Cloud l'invio allo SdI attraverso le API chiede un piano a pagamento, per DATEV Koinos servono l'accreditamento da sviluppatore e la chiave della licenza API, per il Digital Hub documentazione e ambiente di prova passano dai partner di Zucchetti. I passaggi, programma per programma, sono nelle guide dedicate.

| Programma | Limiti |
| --- | --- |
| Fatture in Cloud | 300 richieste ogni 5 minuti per azienda; 1.000 in un'ora e 40.000 in un mese per ogni app pubblica, o per tutte le app private insieme ([limiti e quote](https://developers.fattureincloud.it/docs/basics/limits-and-quotas/)) |
| Aruba Fatturazione Elettronica | Da 60 all'ora e 10.000 all'anno nella fascia più bassa a 30.000 all'ora e 5 milioni all'anno nella più alta |
| DATEV Koinos | 5 al secondo e 300 al minuto per applicazione, più un tetto settimanale per licenza; aggiornamenti controllati al massimo una volta al minuto ([limiti e quote](https://developer.datev.it/Docs/Limits)) |
| Fattura24 | 30 al minuto, 200 all'ora, 500 in 24 ore, una richiesta alla volta |

*Quante richieste accetta ogni programma, al 9 novembre 2026.*

Oltre il limite arriva un errore. Aruba lo dice in chiaro: le richieste in eccesso non restano in coda, e ogni nuova richiesta durante il blocco fa ripartire il conto dell'attesa. Per questo i nostri collegamenti mettono le fatture in coda e le mandano una alla volta, al ritmo che il programma accetta; Fattura24 lo chiede anche perché due documenti creati in parallelo possono prendere il numero progressivo sbagliato.

## Il nostro lavoro parte da quello che il programma permette

Colleghiamo agli altri programmi il software di fatturazione che un'azienda, uno studio o un professionista ha già, in Italia e in Svizzera, partendo da cosa permettono la versione installata o il piano: le API, un servizio che trasmette l'XML o i file. È uno dei lavori delle [integrazioni tra software](https://automatia.it/servizi/integrazioni-api).

In ogni collegamento controlliamo cliente, codici e totali prima che la fattura nasca; gli esiti dello SdI tornano nel gestionale, chi deve correggere riceve un avviso che indica il documento e un registro conserva data, ora ed esito di ogni passaggio.

Se le fatture devono nascere da contratti, DDT o pagamenti online, il collegamento si allunga fino all'incasso, con il servizio di [fatturazione elettronica e incassi](https://automatia.it/servizi/fatturazione-elettronica-e-incassi); termini e controlli li spiega la guida sulla [fatturazione automatica](https://automatia.it/guide/fatturazione-automatica).

Quando il programma non basta più, per esempio con più sedi, più postazioni o vendite su più canali, la fatturazione si sposta in un [gestionale su misura](https://automatia.it/servizi/gestionali-su-misura): se lo costruiamo noi, è compresa la [migrazione dal programma di oggi](https://automatia.it/servizi/migrazione-gestionali) con tutti i suoi dati, e il gestionale nuovo viene adattato a come quei dati sono organizzati.

Se le fatture sono poche e nascono tutte nel programma che le manda allo SdI, un collegamento non serve: lo verifichiamo nella prima chiamata. Come procede il lavoro lo racconta il [metodo](https://automatia.it/metodo); le possibili formule dell'accordo stanno in [formule e costi](https://automatia.it/formule).

## Domande frequenti

**Quale versione del tracciato XML vale nel 2026?**

Le specifiche tecniche della fattura elettronica tra privati sono alla versione 1.9.1, aggiornate al 31 marzo 2026 e utilizzabili dal 15 maggio 2026, con gli schemi VFPR12 per la fattura ordinaria e VFSM10 per la semplificata ([Agenzia delle Entrate](https://www.agenziaentrate.gov.it/portale/specifiche-tecniche-versione-1.9.1-%C2%A0-utilizzabili-dal-15-maggio-2026-)). Sul sito FatturaPA lo schema del file è alla versione 1.2.3, valida dal 1° aprile 2025 ([formato FatturaPA](https://www.fatturapa.gov.it/it/norme-e-regole/documentazione-fattura-elettronica/formato-fatturapa/)), e le specifiche del Sistema di Interscambio sono alla 1.8.4 dal 15 maggio 2026 ([documentazione dello SdI](https://www.fatturapa.gov.it/it/norme-e-regole/DocumentazioneSDI/)). Un gestionale che compone l'XML va aggiornato a ogni cambio.

**Si possono importare le fatture XML in Excel?**

Sì: Excel importa file XML, anche più di uno insieme con un mapping XML, come spiega la [guida di Microsoft](https://support.microsoft.com/it-it/excel/import-xml-data). Con le fatture elettroniche ci sono tre ostacoli: un file .xml.p7m ha la firma CAdES, e l'XML va prima estratto dalla busta; righe, riepiloghi IVA e scadenze si ripetono nella stessa fattura; il totale del documento, nello schema, è facoltativo e non sempre c'è. Con molte fatture conviene un passaggio automatico che metta in colonna solo i campi che servono.

**Cos'è SdICoop e chi deve accreditarsi?**

SdICoop è il servizio web del Sistema di Interscambio: un programma gli manda i file con messaggi SOAP su HTTPS, uno alla volta, fino a 5 megabyte ciascuno. Per usarlo chi trasmette accredita il canale, chiede i certificati, supera le prove di interoperabilità e prende visione dell'accordo di servizio, come descrivono le [specifiche del Sistema di Interscambio 1.8.4](https://www.fatturapa.gov.it/export/documenti/Specifiche-tecniche-relative-al-Sistema-di-Interscambio-versione-1.8.4.pdf). Chi manda le fatture attraverso un programma o un servizio che trasmette per lui non deve accreditarsi: lo fa chi gestisce il canale.

**Per quanto tempo restano scaricabili le fatture XML dall'Agenzia delle Entrate?**

Nel portale «Fatture e Corrispettivi» ogni fattura passata dallo SdI si consulta e si scarica per i due anni interi dopo quello di arrivo: una fattura ricevuta nel 2026, in qualunque mese, resta lì fino al 31 dicembre 2028; poi restano solo i «dati fattura» ([consultazione delle fatture](https://www.agenziaentrate.gov.it/portale/aree-tematiche/fatturazione-elettronica/guida-fatturazione-elettronica/i-servizi-dell-agenzia-fe/consultazione-fatture-e-ricevute)). Per scaricare le fatture XML più vecchie bisogna averle portate in conservazione per tempo: la guida all'[automazione delle fatture passive](https://automatia.it/guide/automazione-fatture-passive) spiega come, anche con il servizio gratuito dell'Agenzia.


## Pagine collegate

- [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.
- [Integrazione Fatture in Cloud](https://automatia.it/guide/integrazione-fatture-in-cloud): Cosa fa e cosa non fa l'API di Fatture in Cloud con gestionale, negozio online e Stripe: fattura elettronica, tetti dei piani, quote, webhook, accessi.
- [Integrazione Danea Easyfatt](https://automatia.it/guide/integrazione-danea-easyfatt): Come si collega Danea Easyfatt: protocollo e-commerce, file Easyfatt-Xml ed Excel, rete locale, altre sedi ed Easyfatt Cloud, con i limiti scritti da Danea.
- [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
