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.
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.
| Prodotto | A chi serve | Porta verso gli altri programmi |
|---|---|---|
| SuperBill Fatture | Chi lavora in proprio, come artigiani e liberi professionisti | API e plug-in: clienti, articoli, documenti di vendita, invio allo SdI |
| SuperBill Impresa | Imprese che vogliono contabilità, vendite, acquisti e magazzino in un programma solo | API e plug-in, con in più acquisti, contratti, scadenze, incassi e pagamenti |
| XML Express | Chi ha già un programma che compone le fatture XML | Caricamento di una fattura o di interi lotti, poi invio allo SdI, ricezione e conservazione |
| IntegraSDI | Programmi esterni, con un accordo di servizio attivo | API per trasmettere XML già pronti e leggere fatture ricevute e corrispettivi |
| DK Set Studio | Studi di commercialisti | Importa 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.
Identità DKid
Chi sviluppa il collegamento entra con DKid, l'identità del produttore, o se la crea.
Profilo da sviluppatore
Dal portale chiede l'attivazione del profilo; il team del produttore la valuta e lo ricontatta per completare l'abilitazione.
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).
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).
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.
| Area | SuperBill Fatture | SuperBill Impresa |
|---|---|---|
| Anagrafiche | Clienti e articoli, da creare e modificare | Clienti, fornitori e articoli, da creare e modificare; listini, prezzi, sconti e promozioni da leggere |
| Documenti | Creazione, lettura, invio allo SdI, scarico del file | Gli stessi, anche d'acquisto, più scadenze, chiusura, incasso e pagamento |
| Contratti | Non previsti | Creazione e attivazione |
| Tabelle da leggere | Codici IVA, pagamenti, registri di numerazione, centri di costo, ritenute, casse | Le 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 Express | API di IntegraSDI |
|---|---|
| Si caricano in pochi clic una fattura o interi lotti, da qualunque programma | Il programma manda uno o più file per chiamata |
| Il controllo di conformità segnala subito l'errore | Esiti e ricevute tornano al programma |
| L'invio allo SdI lo fa la piattaforma | Firma e trasmissione, o solo trasmissione del file già firmato |
| Ricezione dai fornitori e conservazione a norma | Fatture 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).
- Utenza
- dedicata, solo area SuperBill
- App
- di produzione, non condivisa
- Authorization-Key
- del servizio in uso
- Area dati
- Arredi Kappa
- Questa settimana
- 38% del tetto della licenza
- Ritmo
- in coda, al massimo 4 richieste al secondo
- Ultimo 429
- ieri alle 11:02, ripreso dopo 1 secondo
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.
Da leggere insieme
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.
- Italia
- +39 375 669 3055anche WhatsApp
- Svizzera
- +41 76 511 26 10anche WhatsApp
- info@automatia.it
- Operativi
- 24 ore su 24, 7 giorni su 7
- Lingue
- Italiano, inglese o russo
- Ci scrivi
- Prima valutazione
- Breve chiamata