Automatia
Cerca
Contatti

Collegare DATEV Koinos al gestionale, al negozio online e allo studio del commercialista

Per chi usa DATEV Koinos in azienda o in studio: le strade che il produttore documenta, cosa serve per usarle e cosa resta da concordare con il commercialista.

Team Automatia · pubblicata il · aggiornata il · 9 minuti di lettura

Schema delle porte di DATEV Koinos: il gestionale con le API di SuperBill, un altro programma con XML Express o IntegraSDI, lo SdI e DK Set Studio.
In evidenza le API di SuperBill, dove la fattura nasce dai dati del gestionale; con XML Express e IntegraSDI arriva già composta da un altro programma.

In breve. DATEV Koinos apre agli altri programmi tre strade: le API di SuperBill, che creano documenti e li inviano allo SdI; quelle di IntegraSDI, che trasmettono XML pronti e leggono le fatture ricevute; XML Express, che carica XML di qualunque programma. Le API chiedono profilo da sviluppatore e licenza; la prima nota da un altro programma si concorda con lo studio.

Un'azienda incontra DATEV Koinos quando fattura con SuperBill, quando affida allo SdI le fatture composte da un altro programma o quando il suo commercialista lavora con DK Set Studio. Ogni volta c'è qualcosa da collegare: ordini del negozio online, documenti del gestionale, fatture e prima nota per lo studio.

Qui trovi le strade che il produttore documenta, verificate sulle sue pagine il 9 novembre 2026, e i punti che non sono pubblici. Il confronto con gli altri programmi di fatturazione è nella guida su come collegare il software di fatturazione; token, permessi e codici di errore spiegati da zero in quella su cosa sono le API.

Fatturazione elettronica con DATEV Koinos, prodotto per prodotto

Ogni prodotto occupa un posto diverso nel giro delle fatture, e da quel posto dipende cosa si collega dall'esterno.

Prodotti e porte, dalle pagine del produttore e dal portale per sviluppatori consultati il 9 novembre 2026.
ProdottoA chi servePorta verso gli altri programmi
SuperBill FattureChi lavora in proprio, come artigiani e liberi professionistiAPI e plug-in: clienti, articoli, documenti di vendita, invio allo SdI
SuperBill ImpresaImprese che vogliono contabilità, vendite, acquisti e magazzino in un programma soloAPI e plug-in, con in più acquisti, contratti, scadenze, incassi e pagamenti
XML ExpressChi ha già un programma che compone le fatture XMLCaricamento di una fattura o di interi lotti, poi invio allo SdI, ricezione e conservazione
IntegraSDIProgrammi esterni, con un accordo di servizio attivoAPI per trasmettere XML già pronti e leggere fatture ricevute e corrispettivi
DK Set StudioStudi di commercialistiImporta e contabilizza le fatture dei clienti su SuperBill Fatture; nel portale per sviluppatori non ha API

DK Set Studio è il software per commercialisti di DATEV Koinos: contabilità, dichiarativi, bilancio, comunicazioni telematiche, fatturazione elettronica dello studio e dei clienti e condivisione dei dati contabili. In SuperBill Impresa le fatture emesse e ricevute stanno nella piattaforma IntegraSDI, che ha anche API proprie per i programmi esterni; XML Express serve a chi non vuole cambiare il programma con cui le compone.

Cosa serve per usare le API di DATEV Koinos

Per usare le API di DATEV Koinos servono un profilo da sviluppatore approvato, un'App di integrazione e la licenza del cliente; la documentazione, invece, si legge liberamente nel portale per sviluppatori.

  1. Identità DKid

    Chi sviluppa il collegamento entra con DKid, l'identità del produttore, o se la crea.

  2. Profilo da sviluppatore

    Dal portale chiede l'attivazione del profilo; il team del produttore la valuta e lo ricontatta per completare l'abilitazione.

  3. App di integrazione

    Si crea nella sezione Sviluppatore del portale DKid e riceve un Client ID e una chiave privata, con cui il collegamento ottiene i token OAuth 2.0 e OpenID Connect (architettura).

  4. Licenza e Authorization-Key

    La licenza la compra il cliente: nella sezione Licenze e prodotti del suo account trova una chiave per ogni servizio API acquistato, da mandare con ogni richiesta (Authorization-Key).

  5. Area dati

    Ogni chiamata indica, nell'intestazione User-Tenant, l'area dati su cui lavora: un utente DKid può entrare in più di una.

Quando il collegamento chiede l'accesso, chi entra con le proprie credenziali vede l'elenco dei permessi richiesti e lo approva, e il collegamento può usare solo quelli (scope). Per le prove il produttore indica due app per sviluppatore, una per i test automatici e una per quelli manuali, e un'app a parte per la produzione, da non condividere con altre applicazioni (limiti e quote).

C'è poi una regola scritta nella descrizione delle API di SuperBill: se l'utente usato dal collegamento entra in più aree web del produttore, per mandare correttamente i documenti allo SdI se ne crea uno nuovo, con accesso alla sola area SuperBill. Accreditamento e licenza hanno tempi che non dipendono da chi sviluppa: conviene avviarli insieme all'analisi.

Le API di SuperBill, versione Fatture e versione Impresa

Le API di SuperBill sono due, una per versione, e quella di Impresa copre più aree della gestione.

Cosa espongono le due API di SuperBill secondo le specifiche pubblicate nel portale per sviluppatori, consultate il 9 novembre 2026.
AreaSuperBill FattureSuperBill Impresa
AnagraficheClienti e articoli, da creare e modificareClienti, fornitori e articoli, da creare e modificare; listini, prezzi, sconti e promozioni da leggere
DocumentiCreazione, lettura, invio allo SdI, scarico del fileGli stessi, anche d'acquisto, più scadenze, chiusura, incasso e pagamento
ContrattiNon previstiCreazione e attivazione
Tabelle da leggereCodici IVA, pagamenti, registri di numerazione, centri di costo, ritenute, casseLe stesse, più magazzini, aree degli agenti, criteri delle provvigioni, valute e cambi

In tutte e due le API un documento si crea, si legge, si manda allo SdI e se ne scarica il file, ma non c'è un'operazione per cambiarne il contenuto. Gli errori vanno fermati prima della creazione: il collegamento legge dall'archivio codici IVA, registri e modalità di pagamento e trattiene il documento che non li rispetta.

Con la versione Impresa un negozio online crea la fattura dell'ordine, la manda allo SdI e la segna come incassata. Per un bonifico conviene segnarla dopo aver trovato il movimento in banca, come nella riconciliazione bancaria automatica; dal 25 giugno 2026 l'incasso si registra anche su un documento già chiuso, scadenza per scadenza (elenco delle modifiche).

Le API di Impresa creano e attivano anche i contratti: da lì SuperBill prepara le fatture periodiche secondo i parametri del contratto, come nella fatturazione ricorrente. Nella versione Fatture i documenti accettano ritenuta d'acconto, ritenuta previdenziale e casse di previdenza, aggiunte nel 2023: è il punto da guardare quando si collega il programma di un professionista.

Prima di scrivere un collegamento conviene chiedere se ne esiste già uno: il produttore scrive che CRM, e-commerce e gestionali si collegano «tramite API e un apposito plug-in», già pronto o sviluppato apposta. Cosa far passare tra negozio e gestionale lo spiega la guida su come integrare e-commerce e gestionale.

IntegraSDI e XML Express, per gli XML composti da un altro programma

Se le fatture nascono già complete in un altro programma, l'XML si affida a DATEV Koinos in due modi: si carica in XML Express, oppure lo manda il programma stesso con le API di IntegraSDI.

XML ExpressAPI di IntegraSDI
Si caricano in pochi clic una fattura o interi lotti, da qualunque programmaIl programma manda uno o più file per chiamata
Il controllo di conformità segnala subito l'erroreEsiti e ricevute tornano al programma
L'invio allo SdI lo fa la piattaformaFirma e trasmissione, o solo trasmissione del file già firmato
Ricezione dai fornitori e conservazione a normaFatture ricevute e corrispettivi, solo i nuovi o cambiati da una data

IntegraSDI accetta le fatture ordinarie nel formato 1.2 e le semplificate nel formato VFSM10. Sono gli schemi delle specifiche tecniche dell'Agenzia delle Entrate, oggi alla versione 1.9.1, utilizzabile dal 15 maggio 2026. Le sue API sono aperte solo agli utenti accreditati con un accordo di servizio attivo: con quello di emissione la piattaforma firma il file nei casi previsti e lo trasmette, con quello di trasmissione le fatture ordinarie arrivano già firmate, in P7M (specifica pubblicata).

Chi compone l'XML risponde del suo contenuto. Il controllo di XML Express riguarda i requisiti per l'invio allo SdI; aliquote, nature IVA e bollo restano scelte del programma che scrive il file e delle regole decise con il commercialista. Le fatture dei fornitori lette da IntegraSDI entrano poi nell'automazione delle fatture passive, con l'abbinamento a ordini e DDT.

Fatture e prima nota con DATEV Koinos verso lo studio

Cosa arriva allo studio dipende dal programma con cui fatturi: con SuperBill e XML Express il passaggio lo prevede il produttore, con un programma di un altro produttore va concordato.

  • SuperBill Fatture. Se lo studio lavora con il gestionale del produttore, le fatture si importano nel suo programma e si contabilizzano in automatico. Il commercialista può anche trasferire dalla sua contabilità al tuo SuperBill le anagrafiche tue, dei tuoi clienti e dei fornitori, così non si ricopiano.
  • SuperBill Impresa. La contabilità sta nel programma: per ogni documento acquisito prepara la registrazione di prima nota, e i dati si condividono con lo studio.
  • XML Express. Se anche lo studio è cliente del produttore, trova le fatture emesse e ricevute in uno spazio web comune, dove può controllarle, correggerle ed elaborarle.
  • Un altro programma. Le pagine pubbliche non dicono in che forma DK Set Studio riceva la prima nota da programmi esterni: formato, frequenza e conti si chiedono allo studio.

Se la prima nota parte da un programma che non è del produttore, prima di scrivere il collegamento si concordano con lo studio:

  • il formato del file, con un esempio che lo studio ha già importato senza errori;
  • ogni quanto arriva, per esempio ogni settimana o a fine mese;
  • il piano dei conti e le causali, che sono quelli dello studio;
  • come si riconosce una registrazione già importata, per non caricarla due volte;
  • chi corregge un errore, e in quale dei due programmi.

Limiti di richieste, errori e versioni da seguire

Un collegamento con le API del produttore lavora dentro due limiti: quelli per secondo e per minuto, non negoziabili, e il tetto settimanale della licenza.

Per ogni applicazione valgono al massimo 5 richieste per secondo e 300 per minuto; il tetto della settimana vale per tenant, cioè per chi ha la licenza. Oltre l'uno o l'altro arriva l'errore 429, con l'intestazione Retry-After che dice quanti secondi aspettare (limiti e quote, codici di errore).

Il collegamento legge il consumo della settimana da ogni risposta e avvisa prima del tetto. Dati di esempio.

Ogni risposta porta l'intestazione DK-Limit-Info, con le richieste usate nella settimana e il limite della licenza: il collegamento la legge e avvisa prima del tetto, invece di scoprirlo dal primo errore. Le linee guida del produttore aggiungono di non controllare gli aggiornamenti di una risorsa più di una volta al minuto e di tenere in cache le risorse statiche. In un collegamento con SuperBill conviene tenerci anche le tabelle che cambiano di rado, come codici IVA e modalità di pagamento.

Altri due codici chiedono una regola: il 401, token scaduto o non valido, che si risolve rifacendo l'autenticazione, e il 503, una manutenzione che di solito il produttore annuncia con largo anticipo. Le novità delle API stanno nell'elenco delle modifiche: le ultime voci sono del 7 ottobre 2026 e correggono, tra l'altro, il funzionamento di due parametri nella creazione dei documenti di SuperBill Impresa. Chi mantiene il collegamento lo riprova quando una voce tocca le operazioni che usa: è parte dell'assistenza e manutenzione del software.

Il nostro lavoro tra gestionale, SuperBill e studio

Colleghiamo a DATEV Koinos i programmi che aziende, studi e professionisti usano già, dalla porta che il produttore apre in quel caso:

  • un gestionale o un negozio online che crea in SuperBill clienti, documenti, contratti e incassi con le API, con una coda che rispetta i limiti e con i controlli prima della creazione: è il lavoro delle integrazioni tra software;
  • un gestionale su misura che compone l'XML, lo affida a IntegraSDI e ne rilegge esiti e fatture ricevute, oppure prepara i file da caricare in XML Express quando basta il caricamento a mano;
  • il file della prima nota per lo studio, nel formato che lo studio indica, con i suoi conti e le sue causali.

Nell'analisi verifichiamo se esiste già un plug-in, quale licenza API serve e se c'è un accordo di servizio attivo. Il profilo da sviluppatore lo approva il produttore e la licenza la compra l'azienda: nella proposta scritta questi passaggi sono in fila, con chi li fa.

Chi decide di portare la fatturazione in un gestionale su misura costruito da noi trova compresa la migrazione di tutti i dati, con il gestionale adattato a come sono organizzati; verso lo studio partono fatture e prima nota nella forma concordata. Il percorso dalla fattura all'incasso è nella pagina su fatturazione elettronica e incassi.

Se fatturi già con SuperBill e lo studio lavora con DK Set Studio, il passaggio delle fatture c'è già: un collegamento serve solo per i dati che oggi qualcuno ricopia, come gli ordini del negozio, e te lo diciamo nella prima chiamata. Come procede il lavoro lo racconta il metodo; per l'accordo ci sono formule e costi.

Domande frequenti

DATEV Koinos ha delle API?

Sì. Nel portale per sviluppatori ci sono le specifiche per SuperBill, nelle versioni Fatture e Impresa, per IntegraSDI e per la configurazione delle aree dati. Sono file Swagger, che si leggono senza account e da cui gli strumenti per sviluppatori ricavano le richieste di prova; per chiamare le API servono il profilo da sviluppatore approvato e una licenza.

Cos'è DATEV Koinos e che programmi fa?

È una società di software per i professionisti, nata su iniziativa di due cooperative di professionisti da cui prende il nome e legata al gruppo tedesco DATEV. Sul sito del produttore ci sono DK Set Studio per gli studi, SuperBill per chi fattura, Auditev per la revisione e DK Mind, servizi con l'intelligenza artificiale per lo studio, a partire dalla contabilizzazione automatica delle fatture.

Cos'è SuperBill e come si collega a un e-commerce o a un gestionale?

SuperBill di DATEV Koinos è un programma in cloud in due versioni: Fatture, per fatture elettroniche, documenti di vendita e scadenze, e Impresa, che aggiunge contabilità, acquisti, magazzino, contratti e agenti. A un e-commerce, a un CRM o a un gestionale si collega con un plug-in, se ne esiste uno per quel programma, oppure con un collegamento scritto sulle sue API (funzioni di SuperBill Impresa).

Si possono mandare allo SdI, con DATEV Koinos, fatture XML fatte con un altro programma?

Sì, in due modi: si caricano in XML Express, una alla volta o a lotti, oppure le manda il programma stesso con le API di IntegraSDI, se c'è un accordo di servizio attivo. In SuperBill si importano anche i pacchetti di fatture conservati finora con un altro servizio, così l'archivio sta in un posto solo (funzioni di SuperBill Fatture).

Come passo da FattureGO a SuperBill?

SuperBill Fatture ha un'importazione apposta per chi usava FattureGO, un altro programma di fatturazione di DATEV Koinos: passano anagrafiche di clienti e fornitori, beni e servizi e spese. Dopo il trasloco del servizio di fatturazione elettronica, in SuperBill si ritrovano le fatture inviate, ricevute e conservate (importazione da FattureGO). Un collegamento costruito su FattureGO va invece verificato: il portale per sviluppatori pubblica le API di SuperBill.

Se il mio commercialista usa DATEV Koinos, come gli passo fatture e prima nota?

Se fatturi con SuperBill Fatture, gli attivi l'utenza gratuita riservata al commercialista, in più rispetto ai tuoi utenti: entra nel tuo account, controlla i dati, lavora sui documenti e li scarica. Per un medico o un'altra attività sanitaria SuperBill esporta anche il file CSV delle spese sanitarie, da importare nella contabilità dello studio. Con un altro programma, la prima nota segue il formato che indica lo studio.

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

Mettiamo in fila i passaggi con lo studio

Una prima chiamata, breve e senza impegno: ci dite quale prodotto di DATEV Koinos usate voi o il vostro commercialista e cosa oggi si ricopia, e vi diciamo quale strada regge.

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 del collegamento
  1. Ci scrivi
  2. Prima valutazione
  3. Breve chiamata
Scrivici su WhatsApp, al +39 375 669 3055 (si apre in una nuova scheda)